home *** CD-ROM | disk | FTP | other *** search
/ Technotools / Technotools (Chestnut CD-ROM)(1993).ISO / misc_pto / bingo21e / bingo.doc < prev    next >
Text File  |  1991-12-04  |  191KB  |  5,715 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                        The Bingo Programmer's Text Editor
  7.                                A Shareware Product
  8.                                   Version 2.10e
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                                 Reference Manual
  26.                             Copyright 1989,1990,1991
  27.                             Christopher R. S. Schanck
  28.  
  29.                                 December 3, 1991
  30.  
  31.  
  32.  
  33.  
  34.                                 Table of Contents
  35.                                 -----------------
  36.  
  37.      Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . .    1
  38.           Philosophy . . . . . . . . . . . . . . . . . . . . . . . . .    2
  39.           The Shareware Concept and Registering  . . . . . . . . . . .    4
  40.           PsL Shareware Registration . . . . . . . . . . . . . . . . .    5
  41.           Things to Possibly Come  . . . . . . . . . . . . . . . . . .    6
  42.           Support  . . . . . . . . . . . . . . . . . . . . . . . . . .    7
  43.           CompuServe . . . . . . . . . . . . . . . . . . . . . . . . .    8
  44.           Getting the Latest Version . . . . . . . . . . . . . . . . .    9
  45.           Using this Manual  . . . . . . . . . . . . . . . . . . . . .   10
  46.  
  47.      Critical Short Sections . . . . . . . . . . . . . . . . . . . . .   11
  48.           Installing Bingo . . . . . . . . . . . . . . . . . . . . . .   11
  49.           Invoking Bingo . . . . . . . . . . . . . . . . . . . . . . .   12
  50.           Virtual Memory & the PAGESIZE Utility  . . . . . . . . . . .   13
  51.           Impact of Virtual Memory on Performance  . . . . . . . . . .   14
  52.           Bingo and Larger Screen Displays . . . . . . . . . . . . . .   15
  53.           Bingo's Menu System  . . . . . . . . . . . . . . . . . . . .   16
  54.           Bingo's Dialogue Boxes . . . . . . . . . . . . . . . . . . .   17
  55.                String Entry Boxes  . . . . . . . . . . . . . . . . . .   17
  56.                Yes/No Boxes  . . . . . . . . . . . . . . . . . . . . .   17
  57.                Non-Editable Display Boxes  . . . . . . . . . . . . . .   17
  58.                List-Picking Boxes  . . . . . . . . . . . . . . . . . .   18
  59.           Directory Lister . . . . . . . . . . . . . . . . . . . . . .   19
  60.           Bingo and File Names . . . . . . . . . . . . . . . . . . . .   20
  61.           The Status Line  . . . . . . . . . . . . . . . . . . . . . .   21
  62.           KEYCFG: The Keyboard Configuration Program . . . . . . . . .   22
  63.                Key Names . . . . . . . . . . . . . . . . . . . . . . .   22
  64.                'open_end' Identifier . . . . . . . . . . . . . . . . .   25
  65.                'cur_file' Identifier . . . . . . . . . . . . . . . . .   26
  66.                KEYCFG Command Line Options . . . . . . . . . . . . . .   27
  67.           Bingo & The Mouse  . . . . . . . . . . . . . . . . . . . . .   28
  68.                The Mouse Cursor  . . . . . . . . . . . . . . . . . . .   28
  69.                The Mouse at the General Editing Level  . . . . . . . .   28
  70.                The Mouse and The Menus . . . . . . . . . . . . . . . .   30
  71.                The Mouse & Dialogue Boxes  . . . . . . . . . . . . . .   31
  72.                     String Entry Boxes . . . . . . . . . . . . . . . .   31
  73.                     Yes/No Boxes . . . . . . . . . . . . . . . . . . .   31
  74.                     Non-Editable Display Boxes . . . . . . . . . . . .   31
  75.                     List-Picking Boxes . . . . . . . . . . . . . . . .   31
  76.                The Mouse and The ASCII Table . . . . . . . . . . . . .   32
  77.           Bingo and 4Dos . . . . . . . . . . . . . . . . . . . . . . .   33
  78.  
  79.      Basic Editing . . . . . . . . . . . . . . . . . . . . . . . . . .   34
  80.           The Destructive Backspace  . . . . . . . . . . . . . . . . .   34
  81.           Delete EOL vs. Delete Line vs. Delete BOL  . . . . . . . . .   34
  82.           Deleting Words . . . . . . . . . . . . . . . . . . . . . . .   34
  83.  
  84.      File Handling . . . . . . . . . . . . . . . . . . . . . . . . . .   35
  85.           Edit_file & Load_file  . . . . . . . . . . . . . . . . . . .   35
  86.           Choose_file  . . . . . . . . . . . . . . . . . . . . . . . .   35
  87.           Rename_file  . . . . . . . . . . . . . . . . . . . . . . . .   35
  88.  
  89.  
  90.  
  91.  
  92.           Quit . . . . . . . . . . . . . . . . . . . . . . . . . . . .   35
  93.           Quit_all . . . . . . . . . . . . . . . . . . . . . . . . . .   36
  94.           Abort & Abort_all  . . . . . . . . . . . . . . . . . . . . .   36
  95.           Delete_file  . . . . . . . . . . . . . . . . . . . . . . . .   36
  96.           Zap_file . . . . . . . . . . . . . . . . . . . . . . . . . .   36
  97.           Modify_save & Modify_save_all  . . . . . . . . . . . . . . .   36
  98.           Switch_file  . . . . . . . . . . . . . . . . . . . . . . . .   36
  99.           Clean_file & Clean_all . . . . . . . . . . . . . . . . . . .   36
  100.           Pick_file  . . . . . . . . . . . . . . . . . . . . . . . . .   36
  101.  
  102.      Searching . . . . . . . . . . . . . . . . . . . . . . . . . . . .   38
  103.           Regular Expression Search & Replace Examples . . . . . . . .   39
  104.  
  105.      Navigation  . . . . . . . . . . . . . . . . . . . . . . . . . . .   41
  106.  
  107.      Block Handling  . . . . . . . . . . . . . . . . . . . . . . . . .   42
  108.           Marking  . . . . . . . . . . . . . . . . . . . . . . . . . .   42
  109.           Operations on Blocks . . . . . . . . . . . . . . . . . . . .   42
  110.           Named Buffers  . . . . . . . . . . . . . . . . . . . . . . .   43
  111.           Miscellaneous Functions  . . . . . . . . . . . . . . . . . .   43
  112.           Emacs_yank . . . . . . . . . . . . . . . . . . . . . . . . .   43
  113.  
  114.      Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . .   44
  115.  
  116.      Extra Functions . . . . . . . . . . . . . . . . . . . . . . . . .   45
  117.           Help . . . . . . . . . . . . . . . . . . . . . . . . . . . .   45
  118.           Info . . . . . . . . . . . . . . . . . . . . . . . . . . . .   45
  119.           Pick & Exec  . . . . . . . . . . . . . . . . . . . . . . . .   45
  120.           Quit and Save Status . . . . . . . . . . . . . . . . . . . .   45
  121.           Global . . . . . . . . . . . . . . . . . . . . . . . . . . .   46
  122.           Ascii_table  . . . . . . . . . . . . . . . . . . . . . . . .   46
  123.           Load_ & Write_profile  . . . . . . . . . . . . . . . . . . .   46
  124.           Repeat_last  . . . . . . . . . . . . . . . . . . . . . . . .   47
  125.           Display_file . . . . . . . . . . . . . . . . . . . . . . . .   47
  126.           Box Draw Mode  . . . . . . . . . . . . . . . . . . . . . . .   47
  127.           Cmd_line . . . . . . . . . . . . . . . . . . . . . . . . . .   47
  128.  
  129.      System Operations . . . . . . . . . . . . . . . . . . . . . . . .   48
  130.           Changing Directories . . . . . . . . . . . . . . . . . . . .   48
  131.           Simple Execution & Shelling  . . . . . . . . . . . . . . . .   48
  132.           Swap Execution & Shelling  . . . . . . . . . . . . . . . . .   48
  133.  
  134.      Macros  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   50
  135.           Macro Space  . . . . . . . . . . . . . . . . . . . . . . . .   50
  136.           Defining Macros  . . . . . . . . . . . . . . . . . . . . . .   50
  137.           Saving Macros  . . . . . . . . . . . . . . . . . . . . . . .   51
  138.           Saving the Entire Key Set  . . . . . . . . . . . . . . . . .   51
  139.           Executing a Macro File . . . . . . . . . . . . . . . . . . .   51
  140.  
  141.      Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   52
  142.           Window_split, _edit & _load  . . . . . . . . . . . . . . . .   52
  143.           Window_vertical  . . . . . . . . . . . . . . . . . . . . . .   52
  144.           Window_resize  . . . . . . . . . . . . . . . . . . . . . . .   52
  145.           Window_one & Window_zoom . . . . . . . . . . . . . . . . . .   52
  146.  
  147.  
  148.  
  149.  
  150.  
  151.      Printing  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   53
  152.  
  153.      Error Parsing and Undo  . . . . . . . . . . . . . . . . . . . . .   54
  154.           How Error Parsing Works  . . . . . . . . . . . . . . . . . .   54
  155.           Error Parsing Method . . . . . . . . . . . . . . . . . . . .   54
  156.           Undo Capabilities  . . . . . . . . . . . . . . . . . . . . .   55
  157.           Manipulating the Undo Stack  . . . . . . . . . . . . . . . .   56
  158.  
  159.      Configuring Bingo . . . . . . . . . . . . . . . . . . . . . . . .   57
  160.  
  161.      Function List . . . . . . . . . . . . . . . . . . . . . . . . . .   58
  162.           General Editing  . . . . . . . . . . . . . . . . . . . . . .   58
  163.           File Handling  . . . . . . . . . . . . . . . . . . . . . . .   60
  164.           Searching  . . . . . . . . . . . . . . . . . . . . . . . . .   62
  165.           Navigation . . . . . . . . . . . . . . . . . . . . . . . . .   64
  166.           Block Handling . . . . . . . . . . . . . . . . . . . . . . .   67
  167.           Utilities  . . . . . . . . . . . . . . . . . . . . . . . . .   69
  168.           Extra Operations . . . . . . . . . . . . . . . . . . . . . .   71
  169.           System Operations  . . . . . . . . . . . . . . . . . . . . .   73
  170.           Macros . . . . . . . . . . . . . . . . . . . . . . . . . . .   74
  171.           Windows  . . . . . . . . . . . . . . . . . . . . . . . . . .   75
  172.           Printing . . . . . . . . . . . . . . . . . . . . . . . . . .   77
  173.           Error Parsing and Undo . . . . . . . . . . . . . . . . . . .   78
  174.           Configuration  . . . . . . . . . . . . . . . . . . . . . . .   79
  175.  
  176.      License Agreement . . . . . . . . . . . . . . . . . . . . . . . .   85
  177.  
  178.      Registration Form - Bingo 2.10e . . . . . . . . . . . . . . . . .   87
  179.  
  180.      The Author  . . . . . . . . . . . . . . . . . . . . . . . . . . .   89
  181.  
  182.      Acknowledgements  . . . . . . . . . . . . . . . . . . . . . . . .   90
  183.  
  184.      Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   91
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                           Bingo 2.10e Reference Manual
  203.                                         4
  204.  
  205.  
  206.  
  207.  
  208.                                   Introduction
  209.                                   ------------
  210.  
  211.           This document serves as the reference manual for Bingo 2.10e. 
  212.      Bingo is a full-featured text editor at the right price.  Some of its
  213.      features include:
  214.  
  215.      -    high speed execution, with particularly fast searches, screen
  216.           handling, and file I/O
  217.      -    virtual memory for file storage; up to 240 Megabytes of file
  218.           storage possible
  219.      -    full color support
  220.      -    programmable integrated mouse support
  221.      -    support of VGA, EGA, & MCGA extended text modes
  222.      -    superb macro capability
  223.      -    large suite of utility functions: entab; detab; command repeat;
  224.           shift; etc.
  225.      -    custom define your own keyboard setup
  226.      -    complete menu system supporting most Bingo functions
  227.      -    multiple files, multiple windows: view different sections of the
  228.           same file, or different files at the same time
  229.      -    execute DOS commands, including command-line compilers within
  230.           only ~4k of overhead
  231.      -    regular expression search and replace
  232.      -    completely configurable from within itself
  233.      -    use placemarks to mark positions in files
  234.      -    user definable help file
  235.      -    extensive block operation support, include point, line and column
  236.           marking, and two different sets of block operations
  237.      -    one default block buffer, plus 26 additional named buffers
  238.      -    wordwrap, paragraph formatting, and autoindent support included
  239.           for text processing work
  240.      -    C Mode supports programming in the C programming language
  241.      -    User-defined delimiter and indentation matching
  242.      -    directory list picker
  243.      -    execute *any* Bingo function from within Bingo whether it has
  244.           been assigned to a key or not using a 'function picker'
  245.      -    interrupt Bingo at any point and exit, and when you restart Bingo
  246.           it will pick up exactly where you left off
  247.      -    print files & blocks through the serial port, parallel port, or
  248.           to a file, with or without line numbers and/or page headers.
  249.      -    set printing left margin, top margin, and lines per page
  250.      -    automatic processing of errors generated by the Borland and
  251.           Microsoft developmental tools.
  252.      -    undelete stack of deleted items
  253.      -    execute any command or macro "globally" over all files in the
  254.           ring
  255.      -    profile files allow file extension specific settings.
  256.      -    box draw mode for easy screen design
  257.      -    automated, timed backups
  258.  
  259.  
  260.                           Bingo 2.10e Reference Manual
  261.                                         1
  262.  
  263.  
  264.  
  265.  
  266.      Philosophy
  267.      ----------
  268.  
  269.           Text editors are not required for every system; at least, an
  270.      editor of Bingo's power is not.  If all you require of your editor is
  271.      that it allow you to modify batch files and such, Bingo is overkill. 
  272.      Cheap overkill, but still overkill.  However, if you use an editor
  273.      daily, as a programmer, as a consultant who hops from system to system
  274.      and likes to have his/her own tools, or in any other situation where
  275.      you need to depend on it, Bingo could very well be what you are
  276.      looking for.  Why?  In spite of its power, Bingo is very inexpensive,
  277.      and does some things no other editors do, as a look at its feature
  278.      list will convince you.
  279.           People who live with an editor daily for long stretches of time
  280.      know that choosing an editor is a near-religious experience.  Defense
  281.      of your choice develops into a kind of fanaticism.  In the Unix world,
  282.      VI/Emacs wars promise to extend into the next millennium.  It was the
  283.      fact that I could not find an editor I was truly comfortable with that
  284.      prompted me to design Bingo.  In doing so I believe I have created an
  285.      editor that should appeal to a broad base of users.  
  286.           Bingo allows a large degree of latitude when it comes to
  287.      assigning keys.  In a complementary fashion, it allows a user
  288.      specified file to be used for help.  Further, because of Bingo's
  289.      extensive and powerful menuing system, you do not need to memorize a
  290.      large number of keystrokes in order to use Bingo effectively.  This
  291.      allows you to get up and going in a minimum amount of time.
  292.           Bingo has a large degree of programmable mouse support has been
  293.      added.  I have found mouse use to be very nice when editing, and the
  294.      response has been very enthusiastic.  Version 2.10e added an
  295.      additional mouse primitive 'mouse_scroll' which, combined with the
  296.      macro capability, allows you to scroll and drag with your mouse.
  297.           Bingo is optimized for response time.  Screen response in
  298.      particular is very quick, taking full advantage of the PC's direct
  299.      video architecture.  Searches also occur at blazing speed -- a must if
  300.      you spend many hours with an editor.
  301.           Bingo is heavily configurable, all from within the editor itself. 
  302.      This "on-the-fly" ability is a lifesaver if you hop from one system to
  303.      another.
  304.           Bingo has all the standard macro and file handling abilities, but
  305.      it specifically excels at block handling.  Three types of marking, 27
  306.      buffers to use, and a huge array of functions to deal with block
  307.      operations allow you to use blocks to their fullest.
  308.           Especially designed for programmers, Bingo includes a suite of
  309.      utility functions to aid in handling program text.  Functions to shift
  310.      blocks of text left and right, to align blocks, to sort blocks, to
  311.      match delimiters, and to move by indentation are only a few of the
  312.      many handy functions included.  In version 2.10e, you can specify just
  313.      what a delimiter is, say "repeat" and "until".  Then you could sit on
  314.      a "repeat", and let Bingo find the matching "until".
  315.           With version 2.01, a powerful regular expression search and
  316.      replace method has been added.  Further, 'profile' files, which enable
  317.  
  318.                           Bingo 2.10e Reference Manual
  319.                                         2
  320.  
  321.  
  322.  
  323.  
  324.      specific text settings to be associated with files having certain
  325.      extensions, are supported.  To make this useful, each file (or buffer)
  326.      in the ring now maintains its own set of these settings.  This allows
  327.      you to have the correct settings for .DOC files show up when you load
  328.      .DOC files, the correct settings for .CPP files do likewise, and so
  329.      on.
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.                           Bingo 2.10e Reference Manual
  377.                                         3
  378.  
  379.  
  380.  
  381.  
  382.      The Shareware Concept and Registering
  383.      -------------------------------------
  384.           This is just a general note as to what Bingo being Shareware
  385.      means to you, the user.  Shareware could just as easily be called
  386.      "Honorware": I depend upon you honor to mail in your payment for Bingo
  387.      if you are using it regularly.  All of the legal jargon describing
  388.      this Shareware concept is contained in the License & Registration
  389.      section of this manual.
  390.           Basically, I depend upon you to mail in your payment for Bingo
  391.      after you have taken a reasonable amount of time to try it out.  If
  392.      you use it regularly, please mail in the payment.  The number of man-
  393.      hours which went into Bingo is incredible; the registration fee is a
  394.      small price to pay. So if you use Bingo regularly, send me the
  395.      registration fee I charge for Bingo -- it's not much money for a very
  396.      sharp program.
  397.           When you register, you are entitled to a number of advantages,
  398.      depending on how you register.  If your registration is a Single
  399.      Version registration ($40), these benefits include:
  400.           1) If you request it, I will mail you a copy of the current
  401.           release of Bingo free.
  402.           2) You are entitled to support for 9 months, or until 1 month
  403.           past the release of the next version, whichever is longer.
  404.      If your registration is a Lifetime registration ($75), your benefits
  405.      are a little more extensive.  They include:
  406.           1) If you request it, I will mail you a copy of the current
  407.           release of Bingo free.
  408.           2) You are entitled to support for as long as Bingo is marketed
  409.           as a product, be it as shareware or commercial.
  410.           3) The next release will be mailed to you free of charge.
  411.           4) You will be notified of each successive release, and each will
  412.           be available to you for a mere $5.00 shipping fee.
  413.  
  414.           In addition, with version 2.01 and beyond, registered users of
  415.      any sort get to have their named emblazoned on their copy for all to
  416.      see;  this way everyone will know what honorable people they are.  And
  417.      no, a simple sector editor cannot change this name -- it has to be
  418.      done here.  The name will be shown on the initial screen which is
  419.      popped up when bingo is executed, and can also be accessed from the
  420.      'version_info' function.
  421.           Also, some registered users are asked to beta-test upcoming
  422.      versions -- a double-edged sword.  Beta testing is somewhat precarious
  423.      at times, but you do get to take a hand in forming the next version. 
  424.      Plus you get to have your complaints redressed faster than the general
  425.      public.
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.                           Bingo 2.10e Reference Manual
  435.                                         4
  436.  
  437.  
  438.  
  439.  
  440.      PsL Shareware Registration
  441.      --------------------------
  442.  
  443.           You can order directly from me at the below address or from
  444.      Public (software) Library with your MC, Visa, AmEx or Discover
  445.      card by calling 800-2424-PsL or 713-524-6394 or by FAX to
  446.      713-524-6398 or by CompuServe to 71355,470 or by mail to PsL, PO
  447.      Box 35705, Houston, Texas 77235-5705.  Bingo's order # is 10399.
  448.      Please use this number when ordering if possible.  These numbers
  449.      are for ordering only.  For information about dealer pricing,
  450.      volume discounts, site licensing, shipping of product, returns,
  451.      latest version number or other technical information, contact me
  452.      at
  453.  
  454.                        Christopher R. S. Schanck
  455.                        PO Box 279
  456.                        Hanover MD 21076
  457.                        (410) 730-9874
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.                           Bingo 2.10e Reference Manual
  493.                                         5
  494.  
  495.  
  496.  
  497.  
  498.      Things to Possibly Come
  499.      -----------------------
  500.           "The one major thing which still(!) looms in Bingo's future is
  501.           the ability to work with files larger than memory.  I am still
  502.           thinking of implementing a virtual memory method, but it may or
  503.           may not appear in later versions."
  504.  
  505.           This phrase, or something similar, has appeared in the
  506.      documentation of each of the previous versions of Bingo prior to 2.10. 
  507.      However, 2.10 introduced a fast, efficient virtual memory paradigm. 
  508.      Theoretically, it allows you to edit up to 240 Megabytes of file
  509.      storage -- that is a lot of files!  Practically, it means that if you
  510.      have the disk storage, you need not worry about memory constraints
  511.      again.  
  512.           Implementing virtual memory necessitated almost a complete
  513.      rewrite of Bingo.  Hence, not a lot of new functionality was
  514.      introduced in this version; I believe the total is about 20 new
  515.      functions, none of which add major functionality.  Several major
  516.      things are in the works for the future, including customizable menus,
  517.      a new window scheme, and an expanded macro language.  Further, the
  518.      regular expression subsystem is going to be completely rewritten for
  519.      the next release, much as the word functions were for this release.
  520.           Currently (12/91) I am prototyping a full procedural interpreter
  521.      which will be integrated into Bingo.  As I see it now, Bingo has a
  522.      truly incredible amount of functionality, but it is not as accessible
  523.      as I would like.  So, I am working on an interpreted language
  524.      including looping, branching, functions, recursion, variables, and
  525.      more.  This will in all liklihood constitute version 3.0, but I am not
  526.      putting a date on it.  Language implementation is proving as hairy as
  527.      virtual memory was ;-).
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.                           Bingo 2.10e Reference Manual
  551.                                         6
  552.  
  553.  
  554.  
  555.  
  556.      Support
  557.      -------
  558.  
  559.           As any of my registered users will tell you, I am committed to
  560.      supporting Bingo.  Without my users, where would I be?  Anyone,
  561.      registered or not, who calls or writes me will receive prompt and
  562.      (hopefully) useful help.  I particularly like to hear of requests;
  563.      anything you would like to see in Bingo, let me know.  One of my beta-
  564.      testers remarked that he felt like he had a personal editor --
  565.      anything he wanted was added.
  566.           I am now residing in the Baltimore area.  My current address and
  567.      phone number is:
  568.  
  569.           Christopher Schanck
  570.           PO Box 279
  571.           Hanover MD 21076
  572.           (410) 730-9874
  573.  
  574.      You are welcome to call me at the above number, but while the address
  575.      will be stable for the next several years, phone numbers do change. 
  576.      Should this number become invalid for any reason, call (215) 691-1070
  577.      (9am to 6pm, EST).  If you wish, you will be given a number where you
  578.      can currently reach me, or you can leave your name and number, and I
  579.      will return your call within 2-3 days.
  580.           PLEASE feel free to contact me.  I very much like to hear from
  581.      you!  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.                           Bingo 2.10e Reference Manual
  609.                                         7
  610.  
  611.  
  612.  
  613.  
  614.      CompuServe
  615.      ----------
  616.           Recently I became a subscriber to Compuserve.  You can contact me
  617.      there as:
  618.           70541,3614
  619.      On the Internet, that would be:
  620.           70541.3614@compuserve.com
  621.      This is the fastest, most reliable way to contact me.
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.                           Bingo 2.10e Reference Manual
  667.                                         8
  668.  
  669.  
  670.  
  671.  
  672.      Getting the Latest Version
  673.      --------------------------
  674.           If you have a copy of Bingo but are not sure if it is the latest
  675.      version, the best way to find out is by calling the Computer
  676.      Connection BBS in Washington DC.  This is a very large, well-managed
  677.      BBS.  The latest version of Bingo will always be available here, and
  678.      E-Mail left for me will be answered.  The number is (202) 547-2008. 
  679.      Likewise, Bingo will always be on Compuserve, in the IBMNET section,
  680.      generally named BINGO?.ZIP.
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.                           Bingo 2.10e Reference Manual
  725.                                         9
  726.  
  727.  
  728.  
  729.  
  730.      Using this Manual
  731.      -----------------
  732.           This manual is broken into three parts.  The first is comprised
  733.      of small sections concerned with particular little parts of Bingo,
  734.      such as Installation and Invocation.  
  735.           The second part consists of sections on each major functionality
  736.      present in Bingo.  These individual sections are not tutorial in
  737.      orientation, but rather give necessary information needed to utilize
  738.      this functionality.  
  739.           The final section is a listing of all of the functions supported
  740.      by Bingo.
  741.           I suggest that the first time user first read the initial
  742.      sections for pertinent information, then go through the function list
  743.      *thoroughly*.  This will give you a clear idea of the capabilities of
  744.      Bingo.  Then, for clarification, go through the middle sections as
  745.      needed.
  746.           Finally, read the READ.ME file very carefully.  In some cases it
  747.      will have information this file doesn't contain, and it may describe
  748.      some things in greater detail as it is kept as a running log as I make
  749.      changes.
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.                           Bingo 2.10e Reference Manual
  783.                                        10
  784.  
  785.  
  786.  
  787.  
  788.                              Critical Short Sections
  789.                              -----------------------
  790.  
  791.      Installing Bingo
  792.      ----------------
  793.           There are 3 files which are of critical importance for Bingo to
  794.      run. 
  795.           BE.EXE and BE.COM are the executables.  BE.EXE is the actual
  796.      editor executable.  BE.COM is the loader file; this allows Bingo to
  797.      swap itself in and out of memory.  Both of these files MUST, MUST,
  798.      MUST reside in the same subdirectory (Got that?).  If you dislike
  799.      typing 'be' at the DOS command, you CAN rename Bingo's executable. 
  800.      Just rename both the .EXE and the .COM to be the same filename (with
  801.      different extensions), for instance, you might shorten it to B.COM and
  802.      B.EXE (programmer's, being lazy in their typing, will no doubt do
  803.      this; I did ;-)  One point to remember, don't invoke the .EXE file
  804.      directly.  As long as you have both in the same directory, you can
  805.      type 'BE' (no extension), and the .COM file will be executed.  Or you
  806.      can execute the .COM file directly.
  807.           KEYCFG.SET is the compiled keyboard definition file.  This needs
  808.      to be in the same directory as BE.EXE/.COM, or in the current
  809.      directory.
  810.           KEYCFG.EXE is another program of importance; it is the program
  811.      used to generate a keyboard configuration.  It takes the name of a
  812.      configuration file (usually BINGO.CFG) and generates a keyset file
  813.      (usually called KEYCFG.SET).  See the section titled Configuring the
  814.      Keyboard for more information.
  815.           The help file BINGO.HLP, is an additional file which must be in
  816.      the same subdirectory as BE.EXE.  When you invoke help, Bingo will
  817.      look there for the file BINGO.HLP.  The file may contain your own
  818.      description of the current key layout, or just about anything else you
  819.      would like.  Bingo comes with a default help file.
  820.           As an example, assume the Bingo distribution files are contained
  821.      on drive A:, and you are installing Bingo on drive C:.      First,
  822.      move to drive C: and create a directory for bingo, called \bingo using
  823.      DOS's mkdir command.  Move to this subdirectory using 'cd \bingo'. 
  824.      Now copy the files from drive A: over to the proper subdirectory by
  825.      using 'copy A:*.* C:\BINGO'.
  826.           Finally, you probably want to add 'C:\BINGO' to your PATH
  827.      environment variable.
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.                           Bingo 2.10e Reference Manual
  841.                                        11
  842.  
  843.  
  844.  
  845.  
  846.      Invoking Bingo
  847.      --------------
  848.           Starting Bingo is simple.  Simply type:
  849.  
  850.                be <filespec> <filespec> ...
  851.                be.com <filespec> <filespec> ...
  852.  
  853.      at the DOS prompt, and you are off.  One of several things will
  854.      happen.  If each filename you gave is discreet (i.e., no wildcards),
  855.      the files named will each be loaded, one after another.  If a filespec
  856.      matches more than one file, a directory list of matching files will
  857.      pop up which will allow you to choose a file or files.  See the
  858.      section on the Directory List for further explanation.
  859.           If no filespec is given, Bingo will ask behave as if you issued
  860.      'be *.*'.
  861.  
  862.           You may also specify the starting line and column position for
  863.      the each loaded file.  The '/pLL:CC' switch allows you to do this. 
  864.      For example:
  865.  
  866.           be test.doc test2.doc /p10:5 /p20
  867.  
  868.      would load the file TEST.DOC and move to the 10th line, 5th column. 
  869.      TEST2.DOC would begin on the 20th line.  If you do not give a column
  870.      argument, the first column will be assumed.  
  871.  
  872.           Similarly, you can use the '-x<filename>' switch to run a macro
  873.      file on startup.  For Example:
  874.  
  875.           be test.doc test2.doc /xfun1.mac
  876.  
  877.      would load both files, then execute the macro file FUN1.MAC inside the
  878.      buffer holding TEST.DOC.
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.                           Bingo 2.10e Reference Manual
  899.                                        12
  900.  
  901.  
  902.  
  903.  
  904.      Virtual Memory & the PAGESIZE Utility
  905.      -------------------------------------
  906.           In version 2.10, Bingo introduced a virtual memory paradigm to
  907.      allow programmers to edit more and larger files.  Virtual memory is a
  908.      simple, elegant, beautiful concept in the abstract; the reality, on an
  909.      MS-DOS based PC, is a very hairy beasty indeed.  Many different
  910.      methods for implementing virtual memory were examined.  The one I
  911.      settled on seems a good compromise; Bingo is still quick, and the
  912.      memory/disk swapping necessary when you are working with large files
  913.      is relatively unobtrusive.  I still edit fairly regularly on an 8088
  914.      machine, with a 65ms hard disk, and I find Bingo plenty fast enough. 
  915.      On a 386 with a fast drive (say, an 80meg IDE drive with a 32k onboard
  916.      cache), you never even realize it is swapping.
  917.           Bingo treats file storage as a set of fixed length blocks.  As
  918.      shipped, Bingo is generally configured for 2048 byte-sized blocks, or
  919.      2k.  Internally, Bingo can deal with up to 16k of these blocks
  920.      (buckets), configurable from 1k to 16k.  The blocksize, bucketsize, or
  921.      *pagesize*, is configurable from 2k to 16k, in even increments (i.e,
  922.      2k, 4k, 6k, 8k, etc).  The larger the pagesize, the more blocks (or
  923.      buckets) allocated the higher the theoretical memory limit.  For
  924.      instance, a pagesize of 16k with 8k buckets gives a theoretical memory
  925.      limit of 128 Megabytes!  So why not just set the limits way up and be
  926.      done with it, you ask?
  927.           Two reasons.  First, the larger the pagesize, the harder Bingo
  928.      works to manipulate text.  On faster machines, larger pagesizes are
  929.      fine; on a 386/25 Mhz PC, a 16k pagesize is no problem at all.  On the
  930.      other hand, a 2k pagesize is fine on every machine out there, hence
  931.      the default setting.
  932.           The larger the number of buckets allocated, the less conventional
  933.      memory Bingo has available for use.  So allocating a lot more than you
  934.      need is non-optimal use of your resources.
  935.           Second, let's be serious about this.  Seldom, if ever, will
  936.      someone really need to edit a file 200+ Megs in size.  Could happen;
  937.      that is why I coded it as I did.  But still.  Also, do the arithmetic. 
  938.      To edit a 200M file, you need roughly > 400M of disk storage; 200M for
  939.      the file itself, + 200M for the swapfile, + some odd number of bytes
  940.      for the file entries in the FAT table (grin).  Not a lot of systems
  941.      around with several hundred megs of storage hanging about.  But we
  942.      plan for the future.
  943.  
  944.           To set the pagesize, use the PAGESIZE.COM utility.  The syntax is
  945.      :
  946.           pagesize <# buckets> <page size> <.exe file>
  947.      where <# buckets> is the number of buckets (in Kilobytes) to allocate
  948.      on startup and <page size> is the size in Kilobytes (2,4,6,8,...,16)
  949.      and the filename is .EXE name to configure (i.e., BE.EXE).
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.                           Bingo 2.10e Reference Manual
  957.                                        13
  958.  
  959.  
  960.  
  961.  
  962.      Impact of Virtual Memory on Performance
  963.      ---------------------------------------
  964.           Virtual memory has had a measurable impact on Bingo's performance
  965.      in a number of areas.  Users coming from version 2.01 or earlier will
  966.      appreciate this discussion of differences.  
  967.           On the downside, general editing is, in my estimation, a touch
  968.      slower.  Searches, scrolling, block operations, etc.  On the other
  969.      hand,  the only machine I can tell the difference on is an ancient
  970.      8088; use an AT-class machine, and you can't see a difference. 
  971.      However, even on the 8088, things are by no means slow; searches and
  972.      such are still very quick.
  973.           One function in particular is much slower.  When you sort a
  974.      block, things are much, *much* slower in this version.  This is not so
  975.      much a consequence of the virtual memory per se, but of the new memory
  976.      structure.  In version 2.01 and earlier, sorting was done with a
  977.      recursive algorithm (N log N bound), and swapping lines meant swapping
  978.      pointers only.  In version 2.10, a stack-based sort is not acceptable,
  979.      because with a large file you could corrupt the stack.  So the
  980.      excellent CombSort algorithm (April 1991 BYTE) was used instead.  This
  981.      algorithm approximates N log N time, but is ultimately slower.  The
  982.      real speed killer, however, is that I can no longer simply swap
  983.      pointers.  Instead, I have to physically move the lines themselves
  984.      around.  This is slow, slow, slow, pushing the sort time way, way up. 
  985.      But I did not want to eliminate sorting entirely.  I use it too much
  986.      to give up.
  987.           On the upside, obviously, you can edit humongous files with ease,
  988.      and a virtually unlimited number of files.  This is an obvious
  989.      improvement.
  990.           The other highly visible improvement is in File I/O.  File
  991.      reading and writing has been speeded up by something approaching a
  992.      factor of 4.  The larger you set the pagesize, the faster file IO will
  993.      be.  ALthough increasing the pagesize past the size of a disk sector
  994.      will generally not show a lot of improvement.
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.                           Bingo 2.10e Reference Manual
  1015.                                        14
  1016.  
  1017.  
  1018.  
  1019.  
  1020.      Bingo and Larger Screen Displays
  1021.      --------------------------------
  1022.           EGA, VGA, and MCGA video display cards support displays larger
  1023.      than the standard 25 rows by 80 columns.  Bingo does support editing
  1024.      on these screen sizes.   Bingo can be set to handle screen displays in
  1025.      one of three ways:
  1026.           -    Bingo can be set to detect the current screen type and
  1027.                dimensions, and do retrace checking.
  1028.           -    Bingo can be set to detect the current screen type and size,
  1029.                but do no retrace checking.
  1030.           -    Bingo can be set to switch to 43/50 line mode if it is
  1031.                supported.  No retrace checking will be performed.
  1032.      As shipped, Bingo chooses the middle of these three courses.  The
  1033.      retrace checking is only done if you are using a color display with a
  1034.      25x80 configuration.
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.                           Bingo 2.10e Reference Manual
  1073.                                        15
  1074.  
  1075.  
  1076.  
  1077.  
  1078.      Bingo's Menu System
  1079.      -------------------
  1080.           Bingo implements a comprehensive menu structure to aid you in
  1081.      utilizing Bingo's functions.  Many people, myself included, do not
  1082.      necessarily wish to spend the time to assign every function we need to
  1083.      a keyboard equivalent.  This requires a large time investment before
  1084.      you can begin using the editor.  On the other hand, it is very
  1085.      irritating when you need a particular function and cannot use it
  1086.      because you did not have the foresight to assigned it to a key
  1087.      combination.  
  1088.           Bingo's menu system was designed to handle just this situation. 
  1089.      By assigning the 'main_menu' function to a keystroke, you effectively
  1090.      have access to *every* function Bingo has.  First, greater than 75% of
  1091.      Bingo's functions are directly accessible from the menus, grouped in
  1092.      logical sets, following a logical hierarchy.  The remaining functions
  1093.      can be accessed by selecting the 'eXtras' sub-menu, then the 'Pick &
  1094.      exec' function.  This function then allows you to choose from a list
  1095.      of *all* supported functions.
  1096.           I have found that for most people, it pays to assign your most
  1097.      commonly needed functions to keystrokes, and then rely on the menu
  1098.      system for the ones which are used to a lesser degree.  The logical
  1099.      structure of the menus allows for easy access to less frequently
  1100.      needed functions.
  1101.           The menus themselves work quite easily.  A list of possibilities
  1102.      is presented.  A menubar can be moved up and down to make your choice;
  1103.      pressing Return selects the choice.  In addition, each choice has a
  1104.      highlighted character; pressing this character will automatically
  1105.      select the choice.
  1106.           In some cases you may be presented with a child menu.  Here again
  1107.      you may make a choice as before, with one additional bit of
  1108.      functionality.  If you are in a child menu, pressing the PgUp or PgDn
  1109.      keys will move you to the previous or next sibling menu, respectively. 
  1110.  
  1111.           The Print menu, as well as all of the configuration menus, is a
  1112.      multiple menu.  This means that after you have made a choice, the
  1113.      action will be executed and you will be returned to the menu at the
  1114.      same spot.  I have found that when printing and configuring, people
  1115.      usually want to do more than one task.  Menus which are multiple will
  1116.      have an asterisk ('*') printed at the bottom of the menu border.
  1117.           The Escape key always closes the current child menu.  If you are
  1118.      at the top menu, it quits the menu system entirely.  To see how your
  1119.      mouse, if you have one, interacts with the menus, see the section
  1120.      concerning Bingo and a mouse.
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.                           Bingo 2.10e Reference Manual
  1131.                                        16
  1132.  
  1133.  
  1134.  
  1135.  
  1136.      Bingo's Dialogue Boxes
  1137.      ----------------------
  1138.           Throughout Bingo, you will encounter many dialogue boxes.  There
  1139.      are four main types.  They are:
  1140.  
  1141.           String Entry Boxes:
  1142.  
  1143.           These are the boxes which ask you for string input.  The easiest
  1144.      example is when Bingo asks you for a filename.  These boxes allow you
  1145.      to enter string input in a flexible manner.  A wide variety of
  1146.      keystrokes are available to aid in this endeavor; they are:
  1147.  
  1148.                     ^F/CursRt      One Character Forward
  1149.                     ^B/CursLt      One Character Backward
  1150.                     ^A/Home        Beginning of Line
  1151.                     ^E/End         End of Line
  1152.                     ^K/CtrlEnd     Delete to Eol
  1153.                     CtrlHome       Delete to Bol
  1154.                     ^Y             Delete Line
  1155.                     Tab            Insert from Paste Buffer 
  1156.                     Insert         Toggle insert Mode
  1157.                     Alt-A          Invoke the ASCII Table
  1158.                     Up Arrow       Pops up a list of the previous 15
  1159.                                    strings entered.
  1160.                     PgUp           Pops up a list of the previous 15 
  1161.                                    filenames used.
  1162.  
  1163.           Pressing <Escape> will abort out of the string entry operation.
  1164.  
  1165.           Yes/No Boxes:
  1166.  
  1167.           These are the boxes which require a yes or no answer to a
  1168.      question.  An example of this is when you 'quit' a file and the file
  1169.      has been modified.  Bingo will ask you if you wish to save the file.
  1170.           Each time you enter a Yes/No box, one of the two options will be
  1171.      will be highlighted.  This is the default option which will be
  1172.      selected if you press <Return>.  By using the Left and Right Arrow
  1173.      keys, you can change the current selection.  Alternatively, you can
  1174.      press either the 'y' key (any case) for a yes answer, or the 'n' key
  1175.      (any case) for a no answer.
  1176.           Pressing <Escape> will abort the operation.
  1177.  
  1178.           Non-Editable Display Boxes:
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.                           Bingo 2.10e Reference Manual
  1189.                                        17
  1190.  
  1191.  
  1192.  
  1193.  
  1194.           The easiest example of this type of box is the Help box, or the
  1195.      Info box.  This type of box simply displays a number of lines within a
  1196.      box.  By using the Up and Down arrows (also the space bar) you may
  1197.      scroll by lines, and by using the Page Up and Page Down keys you may
  1198.      scroll by pages.
  1199.           Any other keystroke will exit the box.
  1200.  
  1201.  
  1202.           List-Picking Boxes:
  1203.  
  1204.           The best example of this type of dialogue box occurs when the
  1205.      'directory list picker' pops up.  This type of box is very similar to
  1206.      the Non-Editable box discussed above, but the idea here is not merely
  1207.      to display information but to facilitate making a choice.  There will
  1208.      be a menubar highlighted, showing the current selection.  You may move
  1209.      this bar up and down using the arrow and page keys.  Pressing <Return>
  1210.      will selection this option.
  1211.           Additionally, the initial character of each selection may be
  1212.      highlighted.  If so, pressing the corresponding character will
  1213.      automatically select this option.
  1214.           Finally, even if the leading characters of each selection are not
  1215.      so highlighted, you may "step" through the selections by pressing
  1216.      letter keys.  The menubar will move to the next selection which starts
  1217.      with the letter pressed.  If necessary, the menubar will wrap to the
  1218.      top of the list (Bingo will beep in this case).  In the case of the
  1219.      directory picker, the leading '\' characters of directory entries will
  1220.      be ignored.
  1221.           As is the custom, the <Escape> key will abort the operation.
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.                           Bingo 2.10e Reference Manual
  1247.                                        18
  1248.  
  1249.  
  1250.  
  1251.  
  1252.      Directory Lister
  1253.      ----------------
  1254.           One of the extremely useful features of Bingo is its directory
  1255.      lister.  Often, Bingo will ask for a filename.  If the name you give
  1256.      matches more than one file, in the case of wildcards, for instance,
  1257.      the lister will appear with a list of matches and all subdirectories
  1258.      in the current directory.  There are several features embedded in this
  1259.      lister to assist you in choosing a file. 
  1260.           First, all subdirectory entries in the current directory will are
  1261.      shown at the top, with a '\' character preceding them.  Selecting any
  1262.      of these will cause the lister to change to that directory.
  1263.           Second, pressing a letter causes the Lister to move to the next
  1264.      filename whose first character matches the letter pressed.  A beep
  1265.      will sound if the search wraps around to the beginning.
  1266.           The list is sorted alphabetically by name, but subdirectory
  1267.      entries come first.  The last entry is always the New Specification
  1268.      entry, which allows you to type in a new specification, perhaps
  1269.      another drive if it is necessary. 
  1270.           You have 2 choices in the directory lister other than choosing a
  1271.      file.  The second-last option in the list, "Load All Matching Files",
  1272.      will, as you might guess, load all the files shown in the list.  It
  1273.      will not attempt to load subdirectories.  The last option, "New File
  1274.      Spec", allows you to re-choose the directory specification.
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.                           Bingo 2.10e Reference Manual
  1305.                                        19
  1306.  
  1307.  
  1308.  
  1309.  
  1310.      Bingo and File Names
  1311.      --------------------
  1312.           Many times during normal operation, Bingo will ask you for a
  1313.      filename.  Bingo potentially handles filenames slightly differently
  1314.      than plain vanilla DOS.  In particular, let's examine the difference
  1315.      between
  1316.  
  1317.           'thisfile'          &         'thisfile.'
  1318.  
  1319.           The first does not contain a period.  In this case, Bingo will do
  1320.      two things.  First, it will, for each defined default extension, check
  1321.      if the file with that extension exists.  If it does, it will use that
  1322.      filename.  Possibly, on of the default extensions is '.*'.  This would
  1323.      lead you to a directory list picker.  
  1324.           The second contains the trailing period, and so will be used as
  1325.      is.  So, in order to specify a file ignoring the default extensions,
  1326.      you must add the trailing period.
  1327.           Additionally, Bingo accepts either '/' or '\' characters as file
  1328.      delimiters.  This will make life a little easier on those of us who
  1329.      use UNIX systems regularly.  Finally, version 2.10 allows the use of
  1330.      the '..' and '.' directory primitives.
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.                           Bingo 2.10e Reference Manual
  1363.                                        20
  1364.  
  1365.  
  1366.  
  1367.  
  1368.      The Status Line
  1369.      ---------------
  1370.           On the bottom line of each window in Bingo's display is the
  1371.      status line.  This line communicates several valuable pieces of
  1372.      information.  On the left side of the line, the current line and
  1373.      column are displayed.  Next are a series of flags:
  1374.                  a     Autoindent
  1375.                   b     Box Draw Mode
  1376.                  c     C mode 
  1377.                  i     Insert mode
  1378.                  m     Matching Mode
  1379.                  r     Recording Macro
  1380.                  t     Smart Tabs
  1381.                  w     Wordwrap
  1382.                  z     Zoom mode
  1383.      For each of these flags, if the letter is capitalized, it indicates
  1384.      that the toggle is on, while a lowercase character indicates the
  1385.      option is toggled off.
  1386.           Next you will see something looking like [x/y] where 'y' is the
  1387.      number of files in the ring, and 'x' is the position of the current
  1388.      file in the ring.
  1389.           Finally, the full pathname comes.  If it is prefaced with an
  1390.      asterisk '*', it means the file has been modified.
  1391.           At the end of one of the on screen status lines, you will see
  1392.      either one or three little pyramids.  If there is a single pyramid,
  1393.      that means it is not the active window.  If there are three pyramids,
  1394.      they tell you which is the active window.  If the three pyramids are
  1395.      pointing up, the full-width window above the status line is the
  1396.      current window.  If the three pyramids point to the left, this means
  1397.      that of the two windows above the status line, the one on the left is
  1398.      the active window.  If the three pyramids point to the right, the
  1399.      window on the right is active.
  1400.           The same rules concerning the direction of the pyramids hold for
  1401.      inactive status lines, except that only one pyramid will be present.
  1402.           If this all sounds complicated, don't worry.  Open a few windows
  1403.      and move among them; it will become much clearer.
  1404.           Finally, on the right end of the current status line, a 'T' or
  1405.      'F' character will be shown.  This represent whether the last
  1406.      operation Bingo executed returned a value of True or False; i.e.,
  1407.      whether it worked.  This does not have a major impact at the moment,
  1408.      but in future versions it will.
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.                           Bingo 2.10e Reference Manual
  1421.                                        21
  1422.  
  1423.  
  1424.  
  1425.  
  1426.      KEYCFG: The Keyboard Configuration Program
  1427.      ------------------------------------------
  1428.           KEYCFG is the program used to create a keyboard configuration
  1429.      which the Bingo executable can utilize.  The supplied configuration
  1430.      files (BINGO.CFG, EMACS.CFG, possibly others) give a good example of
  1431.      how to set up the file, so this section will simply go over the high
  1432.      points again.
  1433.           KEYCFG is invoked as follows:
  1434.  
  1435.                KEYCFG <configuration name> <keyset filename>
  1436.  
  1437.      <configuration name> is the name of the text configuration source file
  1438.      you wish KEYCFG to read, and <keyset filename> is the name you wish
  1439.      KEYCFG to write the compiled keyboard setup to.  The default keyset
  1440.      file which Bingo looks for on startup is KEYCFG.SET.  Bingo will look
  1441.      first in the current directory, then in Bingo's own home directory. 
  1442.      Alternate keyset files can be loaded from within Bingo using the
  1443.      'key_set_load' function.
  1444.  
  1445.      Key Names
  1446.      ---------
  1447.      f1-f10    are the function keys
  1448.      !f1-!f10  are the shifted function keys
  1449.      @f1-@f10  are the control function keys
  1450.      #f1-#f10  are the alt function keys
  1451.      @<key>    is the control-<key> combination
  1452.      #<key>    is the alt-<key> combination
  1453.      <key>     is a simple key
  1454.  
  1455.      These are named keys:
  1456.  
  1457.           backspace                          up_arrow
  1458.           backtab                            down_arrow
  1459.           tab                                shift_insert
  1460.           escape                             shift_delete
  1461.           ctrl_backspace                     shift_home
  1462.           return                             shift_end
  1463.           ctrl_return                        shift_pgup
  1464.           alt_return                         shift_pgdn
  1465.           ctrl_tab                           shift_right_arrow
  1466.           alt_tab                            shift_left_arrow
  1467.           alt_equal                          shift_up_arrow
  1468.           alt_minus                          shift_down_arrow
  1469.           insert                             ctrl_insert
  1470.           delete                             ctrl_delete
  1471.           home                               ctrl_home
  1472.           end                                ctrl_end
  1473.           pgup                               ctrl_pgup
  1474.           pgdn                               ctrl_pgdn
  1475.           right_arrow                        ctrl_right_arrow
  1476.           left_arrow                         ctrl_left_arrow
  1477.  
  1478.                           Bingo 2.10e Reference Manual
  1479.                                        22
  1480.  
  1481.  
  1482.  
  1483.  
  1484.           ctrl_up_arrow
  1485.           ctrl_down_arrow
  1486.           keypad_plus
  1487.           keypad_minus
  1488.           keypad_divide
  1489.           keypad_aster
  1490.           keypad_return
  1491.           ctrl_keypad_plus
  1492.           ctrl_keypad_minus
  1493.           ctrl_keypad_divide
  1494.           ctrl_keypad_aster
  1495.           ctrl_keypad_return
  1496.           alt_keypad_plus
  1497.           alt_keypad_minus                   Note:  The keynames with
  1498.           alt_keypad_divide                  'grey' in them, as well as
  1499.           alt_keypad_aster                   F11, F12, and several others,
  1500.           alt_keypad_return                  denote keys which are
  1501.           grey_up_arrow                      available only if you have an
  1502.           grey_down_arrow                    extended keyboard, and you
  1503.           grey_left_arrow                    have the 'Use Extended
  1504.           grey_right_arrow                   Keyboard Bios' option turned
  1505.           grey_delete                        on.
  1506.           grey_end
  1507.           grey_home
  1508.           grey_insert
  1509.           grey_pgup
  1510.           grey_pgdn
  1511.           ctrl_grey_up_arrow
  1512.           ctrl_grey_down_arrow
  1513.           ctrl_grey_left_arrow
  1514.           ctrl_grey_right_arrow
  1515.           ctrl_grey_delete
  1516.           ctrl_grey_end
  1517.           ctrl_grey_home
  1518.           ctrl_grey_insert
  1519.           ctrl_grey_pgup
  1520.           ctrl_grey_pgdn
  1521.           alt_grey_up_arrow
  1522.           alt_grey_down_arrow
  1523.           alt_grey_left_arrow
  1524.           alt_grey_right_arrow
  1525.           alt_grey_delete
  1526.           alt_grey_end
  1527.           alt_grey_home
  1528.           alt_grey_insert
  1529.           alt_grey_pgup
  1530.           alt_grey_pgdn
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.                           Bingo 2.10e Reference Manual
  1537.                                        23
  1538.  
  1539.  
  1540.  
  1541.  
  1542.           The configuration file itself consists of lines of the format:
  1543.  
  1544.           <key specifier> <function identifier>
  1545.      or
  1546.           <key specifier> macro <macro list>
  1547.      or
  1548.           <key specifier> <character>
  1549.      or 
  1550.           ; <comment text>
  1551.  
  1552.      A line starting with a space is a continuation of the previous line.
  1553.  
  1554.           <key specifier> is either a simple <key name>, or two key names
  1555.      strung together as <key name>+<key name>.  For instance, for you
  1556.      Wordstar people, control-k q would be entered as
  1557.  
  1558.           @k+q
  1559.  
  1560.      Note: in this case, the Bingo will recognize both the sequence @k+q
  1561.      and @k+Q as the same thing -- case is not significant.
  1562.  
  1563.           The <macro list> is a list of 0 or more function descriptors, as
  1564.      listed in the Function List section, and 0 or more literal
  1565.      occurrences, and 0 or more named keys, in any order.  The literals
  1566.      must be enclosed in single quotes.  The literals will occur in the
  1567.      macro exactly as if they had been typed.  For instance, the line
  1568.  
  1569.           f1    macro 'Chris' return
  1570.  
  1571.      would define the f1 key as my name followed by a return.
  1572.  
  1573.           The <character> is any printable ASCII character, entered without
  1574.      quotes.  For instance, 
  1575.  
  1576.           <    ,
  1577.  
  1578.      would redefined the less-than symbol to be the comma.  This
  1579.      translation will occur during general editing, as well as in the
  1580.      search and replace string-entry boxes.  Everywhere else it will be
  1581.      ignored.
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594.                           Bingo 2.10e Reference Manual
  1595.                                        24
  1596.  
  1597.  
  1598.  
  1599.  
  1600.           The following macro would define the Alt-C key to save all
  1601.      current modified files, execute the make command while swapping Bingo
  1602.      out to disk, saving the errors in the ERRS file, then load the ERRS
  1603.      file.
  1604.  
  1605.           #c        macro save_all swap_execute 'make > errs' return return
  1606.                     load_file 'errs.' return
  1607.  
  1608.           A more interesting variant of this is the one I used prior to
  1609.      installing the auto-error processing:
  1610.  
  1611.           #c        macro modify_save_all swap_execute 'make > errs' return
  1612.                     return window_bottom load_file 'errs.' return
  1613.  
  1614.      This version will attempt to put the errors file in the bottom-most
  1615.      window, and it will initially only save those files as have been
  1616.      modified.
  1617.           After adding  the auto-error processing, I added a more complex
  1618.      version of this macro:
  1619.  
  1620.           #c        macro modify_save_all swap_execute 'make > errs' return
  1621.                     return window_one window_split load_file 'errs.' return
  1622.                     window_previous window_resize down_arrow down_arrow
  1623.                     down_arrow down_arrow down_arrow down_arrow return
  1624.                     setup_err_parse 'errs.' return return next_error
  1625.  
  1626.      This version saves all modified files, executes MAKE as before, and
  1627.      returns.  When it returns, it makes sure there is but one window,
  1628.      splits the current window, and loads in the ERRS file.  It then
  1629.      resizes it so the bottom window is smaller, resets the error parsing
  1630.      to the ERRS file, then searches for the next (first) error.
  1631.           This last version is very sweet to use if you have a compiler
  1632.      which generates agreeable error files.  Bingo will work with most
  1633.      compilers I have come across, including the Borland and Microsoft
  1634.      compilers/assemblers.  With the Microsoft tools, you may have to tweak
  1635.      the compile flags a bit to get a usable format.
  1636.  
  1637.      'open_end' Identifier
  1638.      ---------------------
  1639.           KEYCFG allows the use of the 'open_end' identifier in macros to
  1640.      force Bingo to fetch string input from the keyboard.  For example:
  1641.  
  1642.           f1   macro search open_end 'i' return
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.                           Bingo 2.10e Reference Manual
  1653.                                        25
  1654.  
  1655.  
  1656.  
  1657.  
  1658.      will execute the search function, wait for the user to input the
  1659.      target string, then input 'i' for the search modifier and do the
  1660.      search.
  1661.           'open_end' is effective only for string input --- single key
  1662.      input situations will not respond to it.
  1663.  
  1664.      'cur_file' Identifier
  1665.      ---------------------
  1666.           KEYCFG also allows the use of the 'cur_file' identifier in macros
  1667.      to expand into the current file's name (less path) in string input. 
  1668.      For example:
  1669.  
  1670.           f1   macro load_file cur_file return
  1671.  
  1672.      will force the reload of the current file, providing it is located in
  1673.      the current directory.  NOTE:  There was a bug related to 'cur_file'
  1674.      in version 2.01; basically, if it referenced a filename longer than 11
  1675.      characters (FOOBARED.TXT), bango, you were sunk.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.                           Bingo 2.10e Reference Manual
  1711.                                        26
  1712.  
  1713.  
  1714.  
  1715.  
  1716.      KEYCFG Command Line Options
  1717.      ----------------------------
  1718.           KEYCFG recognizes three command line options.  One is a shortcut:
  1719.  
  1720.           keycfg !
  1721.  
  1722.      tells KEYCFG to assume the name of the configuration file is
  1723.      BINGO.CFG, and that the keyset file is KEYCFG.SET.  I put this in
  1724.      primarily for my own use, as I run KEYCFG often during development.
  1725.  
  1726.           'KEYCFG names' will provide an alphabetical list of all of the
  1727.      function names which are currently recognized.  Useful to have.
  1728.  
  1729.           Likewise 'KEYCFG keys' will list all recognized keynames.  Also
  1730.      useful to have.
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.                           Bingo 2.10e Reference Manual
  1769.                                        27
  1770.  
  1771.  
  1772.  
  1773.  
  1774.      Bingo & The Mouse
  1775.      -----------------
  1776.           Bingo has the capacity to make extensive use of a Microsoft
  1777.      (trademark, copyright, and kudos to Microsoft) compatible mouse,
  1778.      should you have one installed.  In order for the mouse to work, three
  1779.      things must be true. 
  1780.  
  1781.           1) It must be connected to the computer properly.  See your mouse
  1782.      manual for instructions.
  1783.           2) You must have your mouse driver installed properly.  Again,
  1784.      see your mouse manual for instructions on how to accomplish this.
  1785.           3) You must have the 'Use Mouse' option turned on, found in the
  1786.      General configuration menu. Bingo is shipped with mouse use turned on.
  1787.  
  1788.           Bingo is designed to allow users of three button mice to make
  1789.      full use of all three buttons (I have a three button mouse).  However,
  1790.      users with two button mice will only lose a little functionality when
  1791.      it comes to programming the mouse, and no functionality at all when it
  1792.      comes to dealing with the menus and dialogue boxes.
  1793.           It is generally easy to tell if the mouse is working; the status
  1794.      line will have four additional "buttons", each consisting of three
  1795.      arrows enclosed in square braces.  Also, to conserve space, the
  1796.      filename will be shown without its full path.
  1797.  
  1798.      The Mouse Cursor
  1799.      ----------------
  1800.           The mouse cursor will appear on your screen as a solid, non-
  1801.      blinking block, which changes color depending on the underlying color. 
  1802.      It should be possible to move the cursor over the entire screen.  If
  1803.      the mouse cursor is present, it means that a response with the mouse
  1804.      is possible.  If it is not visible, this means that at this point, no
  1805.      mouse response makes sense.
  1806.  
  1807.      The Mouse at the General Editing Level
  1808.      --------------------------------------
  1809.           At the general editing screen, Bingo has 20 programmable mouse
  1810.      events.   The programmable events are handled exactly as key
  1811.      assignments are handled: through KEYCFG.  These are the mouse names:
  1812.  
  1813.                              Mouse Event Identifiers
  1814.  
  1815.           Three_buttons                 Left_right_buttons
  1816.           Left_middle_buttons           Multiple_left_button
  1817.           Single_left_button            Right_middle_buttons
  1818.           Multiple_right_button         Single_right_button
  1819.           Multiple_middle_button        Single_middle_button
  1820.  
  1821.           Single_pyramids               Multiple_pyramids
  1822.           Single_up_arrow               Single_down_arrow
  1823.           Single_left_arrow             Single_right_arrow
  1824.           Multiple_up_arrow             Multiple_down_arrow
  1825.  
  1826.                           Bingo 2.10e Reference Manual
  1827.                                        28
  1828.  
  1829.  
  1830.  
  1831.  
  1832.           Multiple_left_arrow           Multiple_right_arrow
  1833.  
  1834.           The first ten are concerned simply with what happens when you
  1835.      press the corresponding button sequence.  Note that users of two-
  1836.      button devices will only be able to utilize five of these, those
  1837.      dealing with the left and right buttons.
  1838.           The second ten refer to the 5 "hot spots" on the active status
  1839.      line.  There are two for each button, one for a single click and one
  1840.      for a double click.
  1841.  
  1842.           Now that you know of these event names, what can you do with
  1843.      them?  Well, you can assign them anything you could assign a key.  In
  1844.      addition, two special functions are provided to help deal with the
  1845.      mouse:
  1846.  
  1847.           snap_to_mouse_xy:
  1848.                this function moves the cursor to the current mouse
  1849.                position.  If necessary, it will change the active window.
  1850.  
  1851.           mouse_scroll:
  1852.                this function is kind of an expanded snap_to_mouse_xy. 
  1853.                First, it moves the cursor to the mouse position.  Then, as
  1854.                long as a mouse button is held down, the screen will scroll
  1855.                in the following manner:
  1856.                     1) If you are in the upper 1/8 of the screen you will
  1857.                     scroll up.
  1858.                     2) If you are in the next 1/8 of the screen, the screen
  1859.                     will scroll up, but more slowly.
  1860.                     3) If you are in the lower 1/8 of the screen you will
  1861.                     scroll down.
  1862.                     4) If you are in the next lower 1/8 of the screen, the
  1863.                     screen will scroll down, but more slowly.
  1864.                If you are elsewhere on the screen, you simply move the
  1865.                cursor about.  This makes 'click & drag' operations
  1866.                possible.
  1867.  
  1868.  
  1869.      Combining these with other functions, quite powerful mouse events can
  1870.      be programmed.  For example:
  1871.  
  1872.      Single_left_button       snap_to_mouse_xy
  1873.      Single_right_button      macro snap_to_mouse_xy point_mark
  1874.      Multiple_left_button     macro snap_to_mouse_xy linemark
  1875.                                    mouse_scroll linemark
  1876.  
  1877.      The first simply moves the cursor, while the second moves the cursor
  1878.      and drops a point mark.  The third lets you scroll about the file,
  1879.      delineating an area to be marked.
  1880.  
  1881.           The ten "hot spots" can also be programmed as if they were keys.
  1882.        
  1883.  
  1884.                           Bingo 2.10e Reference Manual
  1885.                                        29
  1886.  
  1887.  
  1888.  
  1889.  
  1890.      Single_down_arrow        cursor_down
  1891.      Double_down_arrow        down_page
  1892.  
  1893.      Here, this has defined the down arrow button to respond with a
  1894.      cursor_down if a single click occurs on it, or a down_page if a double
  1895.      click occurs on it.  
  1896.           These "buttons" work a little differently than you might expect -
  1897.      - as long as you hold the mouse button down, the function will
  1898.      repetitively execute.  So, if you double click on the down arrow
  1899.      "button" and hold the second click down, you will see the file whiz by
  1900.      at a truly astonishing speed.  The speed with which the functions are
  1901.      repetitively executed can be governed using the 'conf_mdelay'
  1902.      function.
  1903.           These 20 events give you the user an unparalleled degree of
  1904.      control over how the mouse responds.
  1905.  
  1906.      The Mouse and The Menus
  1907.      -----------------------
  1908.           The mouse would not be very useful if it was not well integrated
  1909.      into the menu system.  Great pains have been taken to make mouse use
  1910.      easy and intuitive with respect to the menu system.  
  1911.           It is very simple.  The left mouse button selects something, and
  1912.      the right mouse button closes the current menu.  However, there are a
  1913.      few refinements.
  1914.           If the item you select with a single left click is in the
  1915.      rightmost menu, the effect is the same as if you had moved to that
  1916.      selection and hit <return>.  If the item is not the rightmost menu,
  1917.      say the it is in the Main menu and you currently have the Block menu
  1918.      open, then you will simply be moved to the selection, with the other
  1919.      menus closed for you.  However, no equivalent <return> will be
  1920.      executed. 
  1921.           If, however, you use a double left click, the selection will be
  1922.      executed regardless of where it was on the menu hierarchy.  Any extra
  1923.      open menus will be closed to bring you to the selected level.
  1924.           Likewise, a single right click will close the current menu. 
  1925.      However, a double click will close *all* open menus.
  1926.           Note that this gives you some capabilities which are not
  1927.      available from the keyboard.
  1928.           If the above sounds complicated, don't worry.  In practice, it is
  1929.      very easy.  I would suggest you restrict yourself to single clicks
  1930.      when you begin, then move to double clicks when you are sure of what a
  1931.      single click would do.  You will very quickly find that the menus are
  1932.      effortlessly intertwined with the mouse.
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.                           Bingo 2.10e Reference Manual
  1943.                                        30
  1944.  
  1945.  
  1946.  
  1947.  
  1948.      The Mouse & Dialogue Boxes
  1949.      --------------------------
  1950.           Throughout Bingo, you will encounter many dialogue boxes.  There
  1951.      are four main types, and all support mouse use where appropriate. They
  1952.      are:
  1953.  
  1954.           String Entry Boxes:
  1955.  
  1956.           These are the boxes which ask you for string input.  The easiest
  1957.      example is when Bingo asks you for a filename.  There are only a few
  1958.      mouse options in these boxes; most of the time you must enter text
  1959.      from the keyboard.
  1960.           However, there are three supported button events.  A single left
  1961.      click has the same effect as a <return>; it accepts the current
  1962.      string.  A double left click wipes out the string; it in effect is a
  1963.      Control-Y equivalent.  Finally, any right button click is the
  1964.      equivalent of an <Escape> key.
  1965.  
  1966.           Yes/No Boxes:
  1967.  
  1968.           These are the boxes which require a yes or no answer to a
  1969.      question.  The easiest example of this is in the configuration
  1970.      options, where you are asked if you wish to toggle the option.  By
  1971.      placing the mouse cursor over the [Yes] selection and pressing the
  1972.      left mouse button, you answer in the affirmative.  Likewise, placing
  1973.      the mouse cursor over the [No] selection and pressing the left button
  1974.      answers in the negative.  
  1975.           As usual, pressing the right mouse button is equivalent to the
  1976.      <Escape> key.
  1977.  
  1978.           Non-Editable Display Boxes:
  1979.  
  1980.           The easiest example of this type of box is the Help box, or the
  1981.      Info box.  If there are more lines than fit within the box, up and
  1982.      down arrow boxes will appear in the upper and lower right hand corners
  1983.      of the box.  By moving the mouse cursor to the corresponding box and
  1984.      holding a mouse button down, the display will scroll in the
  1985.      corresponding direction.
  1986.           As expected, the right button exits.
  1987.  
  1988.           List-Picking Boxes:
  1989.  
  1990.           The best example of this type of dialogue box occurs when the
  1991.      'directory list picker' pops up.  Here, as in the Non-Editable Display
  1992.      Boxes, up and down arrow boxes will appear if necessary.  Furthermore,
  1993.      moving the mouse cursor to a particular selection and pressing a
  1994.      single left key will move the menubar to that selection.
  1995.           Moving the mouse cursor to a particular selection and double left
  1996.      clicking will select that particular selection as if you had moved the
  1997.      menubar there and typed <return>.
  1998.           As always, the right button is the equivalent of typing <Escape>.
  1999.  
  2000.                           Bingo 2.10e Reference Manual
  2001.                                        31
  2002.  
  2003.  
  2004.  
  2005.  
  2006.      The Mouse and The ASCII Table
  2007.      -----------------------------
  2008.           The mouse is also tightly integrated with the ASCII table
  2009.      function, 'ascii_table'.  Here, single left clicking on a character
  2010.      moves the cursor to it (updating the display).  Double left clicking
  2011.      selects the character and adds it to the string.
  2012.           Single left clicking on the [Bspace] bar is equivalent to typing
  2013.      <backspace>; it removes one character from the string.  A double left
  2014.      click on this spot zeroes the string entirely.
  2015.           As always, clicking the right button is the equivalent of typing
  2016.      <Escape>.
  2017.  
  2018.  
  2019.  
  2020.  
  2021.  
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.                           Bingo 2.10e Reference Manual
  2059.                                        32
  2060.  
  2061.  
  2062.  
  2063.  
  2064.      Bingo and 4Dos
  2065.      --------------
  2066.           When version 4.0 of JPSoft's excellent command interpreter was
  2067.      released, users ran into a conflict using Bingo 2.10 with it.  This
  2068.      stemmed from the fact that the core 4Dos executable is 4DOS.COM. 
  2069.      While this file is a .COM file in name, it is actually a 100k+ .EXE
  2070.      format file.  Unfortunately, the spawn() routines used in Bingo
  2071.      currently use the file extension to determine the file type.  Hence,
  2072.      all sorts of unpredictable results occured.
  2073.           JPSoft Technical Support had the following solution:
  2074.  
  2075.           Rename 4DOS.COM to 4DOS.EXE.  
  2076.  
  2077.      Correspondingly, change the 
  2078.           shell=D:\path\4dos.com
  2079.      to
  2080.           shell=D:\path\4dos.exe
  2081.      in your CONFIG.SYS file.  
  2082.  
  2083.           The only side effect noted of this is that 4Dos will not set the
  2084.      COMSPEC environment variable by itself.  So you will need to add
  2085.           COMSPEC=D:\path\4dos.exe
  2086.      to your AUTOEXEC.BAT file.  
  2087.  
  2088.           This should clear up any problems with 4Dos or any like program.
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.                           Bingo 2.10e Reference Manual
  2117.                                        33
  2118.  
  2119.  
  2120.  
  2121.  
  2122.                                   Basic Editing
  2123.                                   -------------
  2124.  
  2125.           Basic editing concerns deletion and insertion of characters. 
  2126.      Bingo provides a number of ways to delete text without recourse to the
  2127.      block operation.  Five of these operations push deleted text onto the
  2128.      unkill stack -- 'del_eol', 'del_line', 'del_bol', 'del_word_lt', and
  2129.      'del_word_rt'.   
  2130.  
  2131.      The Destructive Backspace
  2132.      -------------------------
  2133.           Bingo supports three backspace deletion modes.  The first is the
  2134.      old favorite, the simple one character destructive backspace.    The
  2135.      second mode destructively deletes back to the previous tab stop,
  2136.      provided there are only spaces in the way.  If there are non-space
  2137.      characters in the way, it functions as in mode 1.
  2138.           The final mode deletes all the way to the left margin (column 1),
  2139.      provided it consists only of spaces.  Again, if there are non-space
  2140.      characters, it functions as mode 2.
  2141.  
  2142.      Delete EOL vs. Delete Line vs. Delete BOL
  2143.      -----------------------------------------
  2144.           The 'del_eol' function deletes the remainder of the line from the
  2145.      cursor position.  If you are on the end of a line, it brings the next
  2146.      line up to the current position.
  2147.           The 'del_line' simple deletes the entire current line, no
  2148.      questions asked.  
  2149.           The 'del_bol' deletes from the current position back to the
  2150.      beginning of the line.  If you are at the begging of a line, nothing
  2151.      happens.
  2152.           In all three cases, the deleted text is pushed onto the undo
  2153.      stack.
  2154.  
  2155.      Deleting Words
  2156.      --------------
  2157.           The 'del_word_lt' & 'del_word_rt' functions delete to the start
  2158.      of the next word, left or right, respectively.  What is a word?  This
  2159.      is up to you.  You can configure the string describing what delimits a
  2160.      word via the 'conf_word' function.  The deleted text is pushed onto
  2161.      the unkill stack;
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.                           Bingo 2.10e Reference Manual
  2175.                                        34
  2176.  
  2177.  
  2178.  
  2179.  
  2180.                                   File Handling
  2181.                                   -------------
  2182.  
  2183.           Bingo has extensive file handling capabilities, more than almost
  2184.      any other editor available.  Literally, there is little you could want
  2185.      to do with a file which Bingo will not let you do.  
  2186.           A couple of words are in order about the file format.  Bingo
  2187.      cares not at all if the file you are reading is delimited by carriage-
  2188.      return/linefeed pairs or just linefeed characters; Bingo will read
  2189.      both with equal aplomb.  Similarly, Bingo doesn't object to files
  2190.      ending with the EOF character (ASCII 26).  On output, the output
  2191.      format is governed by the configuration settings accessible through
  2192.      the 'conf_eof' and 'conf_lfs' functions. 
  2193.  
  2194.           Here are some of the high points in file handling with Bingo.
  2195.  
  2196.      Edit_file & Load_file
  2197.      ---------------------
  2198.           Editing a file with an 'edit_file' function may not always
  2199.      physically load the file from disk.  If the asked for name is already
  2200.      being edited, you will simply be moved to the proper buffer. 
  2201.      Conversely, loading a file with the 'load_file' function will always
  2202.      load the file from disk; if it exists in the ring currently, the in-
  2203.      memory version will be killed first.
  2204.  
  2205.      Choose_file
  2206.      -----------
  2207.           The 'choose_file' function pops up a list of the current files in
  2208.      the ring, and allows you to choose from among them.  Also, the option
  2209.      to edit a new file exists; this option is equivalent to the
  2210.      'edit_file' function.
  2211.  
  2212.      Rename_file
  2213.      -----------
  2214.           The 'rename_file' function changes nothing on the disk until you
  2215.      save the file explicitly; however, it does change the name of the in-
  2216.      memory file.
  2217.  
  2218.      Quit
  2219.      ----
  2220.           This is the usual way to exit a file.  If the file has not been
  2221.      modified, Bingo will immediately quit the file.  If the file has been
  2222.      modified, Bingo will ask you if you wish to save the file.  Remember
  2223.      that in this case, a <return> indicates a yes answer.
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.                           Bingo 2.10e Reference Manual
  2233.                                        35
  2234.  
  2235.  
  2236.  
  2237.  
  2238.      Quit_all
  2239.      --------
  2240.           This function repeatedly does a 'quit_file' on each file in the
  2241.      ring.  You can abort the operation at any time by typing <Escape> in
  2242.      response to a query.
  2243.  
  2244.      Abort & Abort_all
  2245.      -----------------
  2246.           These are very dangerous functions.  'abort' exits the file, no
  2247.      questions asked.  'abort_all' exits the program, no questions asked.
  2248.  
  2249.      Delete_file
  2250.      -----------
  2251.           This is just an easy way to delete an arbitrary file on disk.  No
  2252.      more, no less, but sometimes you do need free up disk space.
  2253.  
  2254.      Zap_file
  2255.      --------
  2256.           This allows you to wipe out the disk copy of the currently active
  2257.      file.  It does nothing to the in-memory version of the file itself.
  2258.  
  2259.      Modify_save & Modify_save_all
  2260.      -----------------------------
  2261.           These functions respectively save the current file or each file
  2262.      if and only if it has been modified.  Useful when saving files to
  2263.      compile, so that only modified files get recompiled.
  2264.  
  2265.      Switch_file
  2266.      -----------
  2267.           This function essentially performs a 'quit_file' followed by an
  2268.      'edit_file'.
  2269.  
  2270.  
  2271.      Clean_file & Clean_all
  2272.      ----------------------
  2273.           These functions allow you to reset the status of the file (or all
  2274.      the files) to unmodified.
  2275.  
  2276.      Pick_file
  2277.      ---------
  2278.           Bingo will, if asked, maintain a list of the 15 most recently
  2279.      edited files.  Based on the setting via the 'conf_name_save' function,
  2280.      the files will be saved in either the current directory or in Bingo's
  2281.      home directory.  'Pick_file' will popup a list of the 15 files, most
  2282.      recent at the top.  By selecting a file, you are invoking the
  2283.      'edit_file' function on it.
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.                           Bingo 2.10e Reference Manual
  2291.                                        36
  2292.  
  2293.  
  2294.  
  2295.  
  2296.      Backup_file & Backup_all
  2297.      ------------------------
  2298.           These functions will force a backup attempt of the current file
  2299.      ('backup_file') or each file in the ring ('backup_all').  Only files
  2300.      which have automatic backups turned on will be affected (See the
  2301.      'conf_timed_backups' function.)
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319.  
  2320.  
  2321.  
  2322.  
  2323.  
  2324.  
  2325.  
  2326.  
  2327.  
  2328.  
  2329.  
  2330.  
  2331.  
  2332.  
  2333.  
  2334.  
  2335.  
  2336.  
  2337.  
  2338.  
  2339.  
  2340.  
  2341.  
  2342.  
  2343.  
  2344.  
  2345.  
  2346.  
  2347.  
  2348.                           Bingo 2.10e Reference Manual
  2349.                                        37
  2350.  
  2351.  
  2352.  
  2353.  
  2354.                                     Searching
  2355.                                     ---------
  2356.  
  2357.           There are two search algorithms present in Bingo.  One is very
  2358.      simple and very fast, and part of it is hand-coded in assembler for a
  2359.      bit more speed yet.  For 95% of what you want to do, it is just right.
  2360.           However, with the advent of version 2.01, a second search
  2361.      algorithm was added; a regular-expression method.  Regular expressions
  2362.      are a mathematical way to describe strings of text, and are very
  2363.      powerful.  Bingo's algorithm is reliable but not overly speedy; I
  2364.      suggest you keep this in mind when using it.
  2365.           If you are not familiar with regular expressions, I am not going
  2366.      to attempt to explain them to you here.  If, however, you have used
  2367.      them before, I will explain the notations I used in coding Bingo's
  2368.      algorithm.
  2369.           To perform a regexp search, use the 'R' modifier on you search
  2370.      (or replace).  If you use this modifier, the string will be
  2371.      interpreted as follows:
  2372.  
  2373.           -    classes, i.e. [0-9] and 'not' classes, i.e [~0-9]
  2374.           -    occurrences of once, once or none (?), one or more (+), none
  2375.      or more (*)
  2376.           -    grouping  {}
  2377.           -    ORing of {} groups |
  2378.           -    wildcard character .
  2379.           -    match begin and end of lines with ^ and $, respectively
  2380.           -    support for debugging regular expression search 
  2381.                patterns
  2382.           -    along with regular expression searches, you can specify the
  2383.                replacement in terms of the matched text.  '@n' in the
  2384.                replacement pattern places the text matching the nth group.
  2385.                '@@' matches the entire matched text. This allows you to do
  2386.                some nifty text manipulation.
  2387.  
  2388.           For some simple examples, see below.
  2389.  
  2390.           It is easy to limit the search area to a specific range by line
  2391.      marking a range of text.  Any search (or replace) which starts within
  2392.      a block will not move past the end of the block.  Basically, this
  2393.      means that no search or replace will continue past the end of a block.
  2394.           The 'C' option in the 'search' function will count the number of
  2395.      occurrences of the target string in the rest of the search area.
  2396.           The 'G'lobal option for search and replace operations starts from
  2397.      the current cursor position, not from the top of the file.
  2398.           Try the Search & Macro capability -- it is sharp.
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.                           Bingo 2.10e Reference Manual
  2407.                                        38
  2408.  
  2409.  
  2410.  
  2411.  
  2412.      Regular Expression Search & Replace Examples
  2413.      --------------------------------------------
  2414.           Here are some examples of regular example search and replace.
  2415.  
  2416.      Search for --> [a-z]+/.
  2417.           would match any sequence of one or more letters between 'a' and
  2418.           'z' followed by a single period.
  2419.  
  2420.      Search for --> help[a-z]+/.
  2421.           would match a sequence of 'help' followed by one or more letters
  2422.           then a single period.  It would match 'helpoooooo.' and 'helpp.'
  2423.           but not 'help.'
  2424.  
  2425.      Search for --> 19{87}|{88}
  2426.           would match '19' followed by one occurance of either '87' or
  2427.           '88'.
  2428.  
  2429.      Search for --> 19{87}*|{88}
  2430.           would match '19' followed by none or more occurances of '87' or a
  2431.           single occurance of '88'.  Thus it would match '19',
  2432.           '1987878787', or '1988'.
  2433.  
  2434.      Search for --> .
  2435.           matches any single character. (Note: /. would match a an actual
  2436.           period.)
  2437.  
  2438.      Search for --> ^[a-z]+
  2439.           matches a sequence of 1 or more letters, provided it starts a
  2440.           line.
  2441.  
  2442.      Search for --> ^[a-z]+$
  2443.           matches a sequence of 1 or more letters, provided it starts a
  2444.           line and ends a line.
  2445.  
  2446.      Search for --> ^[a-z]+/.[a-z]+
  2447.           basically matches filenames made up of alpha characters, which
  2448.           are found at the beginning of a line.
  2449.  
  2450.      Search for --> ^$
  2451.           matches a blank line.
  2452.                     
  2453.      Search for --> ^.
  2454.           matches a non-blank line.
  2455.  
  2456.      These last two allow you to do some neat stuff using
  2457.      the macro capability, i.e., apply a macro to every
  2458.      non-blank line.
  2459.  
  2460.  
  2461.  
  2462.  
  2463.  
  2464.                           Bingo 2.10e Reference Manual
  2465.                                        39
  2466.  
  2467.  
  2468.  
  2469.  
  2470.      Search for --> {[a-z]+}{/.}{[a-z]+}
  2471.      Replace with -->  @3.@1
  2472.           This will match a sequence of one or more letters, followed by a
  2473.           period, followed by one or more letters (a filename,
  2474.           essentially).  The replace will put the text matching the 3rd
  2475.           group first, then a period, then the text matching the 1st group. 
  2476.           On a filename, this will have the effect of reversing the order
  2477.           of the name and the extension, i.e:
  2478.  
  2479.                filename.txt
  2480.  
  2481.           would become
  2482.  
  2483.                txt.filename
  2484.  
  2485.           since 'filename' would match the first group and 'txt' matches
  2486.           the third group.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.  
  2516.  
  2517.  
  2518.  
  2519.  
  2520.  
  2521.  
  2522.                           Bingo 2.10e Reference Manual
  2523.                                        40
  2524.  
  2525.  
  2526.  
  2527.  
  2528.                                    Navigation
  2529.                                    ----------
  2530.  
  2531.           Navigation in Bingo is very straightforward.  You may move in
  2532.      terms of characters, lines, words, windowfuls, and the entire file. 
  2533.      You can also jump to the beginning and end of a marked block. 
  2534.      Finally, you can jump to a specified line, or by a relative number of
  2535.      lines, in the file using the Jump function.
  2536.           In addition, Bingo supports placemarks.  I had never really used
  2537.      placemarks much, or "bookmarks" as they are sometimes called.  But a
  2538.      buddy of mine told me to try them when in big files, and I was
  2539.      impressed.  But the editor I tried them in allowed only one; this is
  2540.      just not enough.  So I went one better.  Actually, I went 9 better.
  2541.           Bingo provides 10 placemarks.  You can drop one, jump to one, or
  2542.      pop up a list of the current placemarks.  Each placemark defines a
  2543.      file, a line, and a column.  When you try to jump to a placemark and
  2544.      the file it pertains to is not in the ring, the file will be fetched.
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.                           Bingo 2.10e Reference Manual
  2581.                                        41
  2582.  
  2583.  
  2584.  
  2585.  
  2586.                                  Block Handling
  2587.                                  --------------
  2588.  
  2589.      Marking
  2590.      -------
  2591.           Block marking is extremely flexible.  Three types of marking are
  2592.      supported.  Line marking considers lines to be the smallest
  2593.      indivisible chunks of text.  It is primarily used when editing large
  2594.      sections of program code, since much of this type of editing involves
  2595.      moving lines.
  2596.           Point marking, on the other hand, considers single characters to
  2597.      be the smallest indivisible portions of text.  this is useful for
  2598.      replicating portions of lines, rather than whole lines. 
  2599.           While Point marking "snakes" the mark from one point to the next,
  2600.      Vertical marking lets you define corners of a column-oriented block.
  2601.           As of 2.10c there are two methods of marking, governed by the
  2602.      'conf_automark' function.  If auto-marking is turned off, marking
  2603.      proceeds as follows: go to the beginning of the block you wish to
  2604.      mark; execute the appropriate mark function for the block type you are
  2605.      interested in; move to the end of the block you wish to mark; mark
  2606.      again.
  2607.           If automarking is turned on, things work differently.  Now, when
  2608.      you mark, you turn marking 'on'.  As you move about the file, the
  2609.      block will follow you until you decide to mark the end.  However, you
  2610.      do not have to mark the end of the block; Bingo will simply assume the
  2611.      current position is the other end of the block.
  2612.           You can also use the 'extend_mark' function.  This simply extends
  2613.      the current marking scheme to the current cursor position.  If there
  2614.      is no mark in the file, 'Extend_mark' will display an error message.
  2615.  
  2616.      Operations on Blocks
  2617.      --------------------
  2618.           Bingo supports two slightly different sets of block operations. 
  2619.      The first set will be familiar to users of many programming editors,
  2620.      while the second will bring back memories of any Wordstar compatible
  2621.      editor they may have used.
  2622.           The first set of operations consists of three functions: 'cut',
  2623.      'copy', 'paste'.  'cut' snips the marked region to the block buffer,
  2624.      removing it from the file.  'copy' does the same thing, but it leaves
  2625.      the marked text intact in the file.  In both cases, if nothing is
  2626.      marked and you have this option turned on, Bingo will assume you wish
  2627.      the current line to be linemarked.
  2628.           'paste' is very simple: whatever is currently in the block buffer
  2629.      is placed at the current cursor position, based on the marking method
  2630.      used.  If the contents were point marked, the contents are simply
  2631.      'squirted' into the text.  If the contents were line marked, the lines
  2632.      are inserted above the current line.
  2633.  
  2634.           There is also an alternate type of paste operation, that of
  2635.      'paste_replace'.  In this case, the paste buffer's contents overwrite
  2636.      the needed amount of space in the text, rather than squirting between
  2637.  
  2638.                           Bingo 2.10e Reference Manual
  2639.                                        42
  2640.  
  2641.  
  2642.  
  2643.  
  2644.      existing text.  This type of pasting will only work for Column and
  2645.      Line marked blocks.  Be careful! You can hurt yourself with this one.
  2646.           The second type of block operations available are similar in
  2647.      nature to those used by Wordstar-compatible editors.  Block operations
  2648.      consist of three steps: mark the text, move to the destination
  2649.      position, invoke the function.
  2650.           'block_move' moves the currently marked blocked of text to the
  2651.      current cursor position.  'block_copy' does the same thing, except it
  2652.      leaves a copy behind.
  2653.           'block_delete' is functionally identical to Cut, except that it
  2654.      requires that a block be marked; the setting of the auto linecut
  2655.      toggle has no effect on 'block_delete'.
  2656.  
  2657.      Named Buffers
  2658.      -------------
  2659.           In addition to the default paste buffer, Bingo supports 26 named
  2660.      buffers, 'a'-'z'.  In order to change which buffer is currently in
  2661.      use, use the 'name_buffer' function.  Press the letter of the buffer
  2662.      you want, or <return> for the default buffer.  Until you change the
  2663.      buffer, Bingo will use the currently named buffer for all its
  2664.      operations.  All buffers will be saved when a swapping operation is
  2665.      being done.
  2666.  
  2667.      Miscellaneous Functions
  2668.      -----------------------
  2669.           The 'buffer_info' function displays various pertinent info about
  2670.      all the paste buffers, as well as which buffer is the currently active
  2671.      one.  
  2672.           The 'look_buffer' function will display the current contents of
  2673.      the current paste buffer in a non-editable window, up to the first 100
  2674.      lies.  That should be enough to give you an idea of what is in there.
  2675.           The 'report_bsize' function reports the size of the currently
  2676.      marked block in terms of lines and characters.
  2677.  
  2678.      Emacs_yank
  2679.      ----------
  2680.           This function melds the unkill stack and the paste buffer
  2681.      together in the following manner.  If the most recent block
  2682.      operation/deletion was a block operation, 'emacs_yank' works exactly
  2683.      like 'paste', pushing the paste buffer contents into the text.  If the
  2684.      most recent operation was a deletion (word, line, -eol, -bol),
  2685.      'emacs_yank' works like the 'paste_kill' function, pulling text from
  2686.      the undo stack without disturbing its contents.  This allows you to
  2687.      use the deletion commands to manipulate text in concert with the paste
  2688.      buffer operations.
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.  
  2695.  
  2696.                           Bingo 2.10e Reference Manual
  2697.                                        43
  2698.  
  2699.  
  2700.  
  2701.  
  2702.                                     Utilities
  2703.                                     ---------
  2704.  
  2705.           Bingo provides large number of utilities to be used to manipulate
  2706.      text.  Functions are available to:
  2707.  
  2708.           -    change the case of a block
  2709.           -    strip the high bit from characters in a block
  2710.           -    place tabs within text, and expand tabs within text
  2711.           -    shift blocks a certain number of spaces
  2712.           -    align lines with other lines
  2713.           -    sort blocks, in ascending or descending order, on a
  2714.                particular column
  2715.           -    fill a vertically-marked block with a specific character 
  2716.           -    format a paragraph
  2717.           -    count the number of words over a span of lines
  2718.           -    insert the current time and date into the file
  2719.  
  2720.           The big thing with the utilities is: play with them.  They allow
  2721.      you to do some really useful things to your text.  Particularly,
  2722.      entab/detab are very useful when importing files from other
  2723.      systems/editors.  You can take a file with hard tabs in it which
  2724.      assumed a tabsize of 8 characters, detab it, change the tabsize to 3,
  2725.      entab it, and save it ready for another editor which demands hard tabs
  2726.      with a tabsize of 3.
  2727.  
  2728.  
  2729.  
  2730.  
  2731.  
  2732.  
  2733.  
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.                           Bingo 2.10e Reference Manual
  2755.                                        44
  2756.  
  2757.  
  2758.  
  2759.  
  2760.                                  Extra Functions
  2761.                                  ---------------
  2762.  
  2763.      Help
  2764.      ----
  2765.           The 'help' function attempts to read the file BINGO.HLP located
  2766.      in the same directory as BE.EXE.  This file can consist of anything
  2767.      you wish, and contain as many lines as you wish (it must fit into
  2768.      memory...).
  2769.  
  2770.      Info
  2771.      ----
  2772.           This function simply brings up some useful info, such as the size
  2773.      each file will be when written to disk, current date and time, etc.
  2774.  
  2775.      Pick & Exec
  2776.      -----------
  2777.           This function asks for a function descriptor to execute.  The
  2778.      same function descriptors are used as are used by KEYCFG.  If you give
  2779.      it an unrecognized descriptor, a list of all supported functions are
  2780.      popped up for your convenience.  If you give it substring, such as
  2781.      'win', all functions descriptors which contain 'win' anywhere will be
  2782.      shown; in this case the window functions.  Tie this to an easy to
  2783.      remember key and all of Bingo's functions are at your fingertips.  
  2784.           This is also useful when you are trying to remember a particular
  2785.      function descriptor and you don't have the documentation handy.
  2786.  
  2787.      Quit and Save Status
  2788.      --------------------
  2789.           This simply saves the current Bingo status information, copies of
  2790.      all current files, and exits.  When you next start Bingo, it will ask
  2791.      if you wish to restore Bingo to its previous state.  If you say yes,
  2792.      you will be placed exactly where you left off.  If you indicate no,
  2793.      Bingo will proceed normally, leaving the suspension files in place to
  2794.      be dealt with the next time Bingo is invoked.
  2795.           This function is ultra-useful since it allows for easy
  2796.      interruptions when you are working.
  2797.  
  2798.  
  2799.  
  2800.  
  2801.  
  2802.  
  2803.  
  2804.  
  2805.  
  2806.  
  2807.  
  2808.  
  2809.  
  2810.  
  2811.  
  2812.                           Bingo 2.10e Reference Manual
  2813.                                        45
  2814.  
  2815.  
  2816.  
  2817.  
  2818.      Global
  2819.      ------
  2820.           This is an *extremely* powerful function.  When invoked, it asks
  2821.      for a keystroke to execute globally.  The keystroke can invoke a
  2822.      macro, or simple be tied to a function.  For each file in the ring,
  2823.      Bingo will ask if you wish the function to be executed; your options
  2824.      are the same as they are when doing a search & replace operation: 
  2825.           Y         Yes, do operation, go to next file
  2826.           N         No, don't do operation, but do go to next file
  2827.           O         Yes, do the operation, but abort the global operation
  2828.                     afterwards.
  2829.           G         Yes, do the operation, and do it for all remaining
  2830.                     files without asking.
  2831.           Q         Abort the global operation right now.
  2832.      You must be *very* careful when using this operation; any functions
  2833.      which change the number of files in the ring can be dangerous.  Be
  2834.      prudent when using it, and you will be fine, use it without some
  2835.      forethought, and you may get bitten and regret it.
  2836.           In version 2.10, this function was cleaned up a good deal; it
  2837.      should be rock-steady reliable, and much cleaner in its interface.
  2838.           Remember, do NOT use this function while recording a macro; you
  2839.      will get unpredictable results.
  2840.  
  2841.      Ascii_table
  2842.      -----------
  2843.           This function serves a dual purpose.  First, it will pop up a
  2844.      display of all 256 characters, serving as a handy reminder of the
  2845.      characters available.  As you move the cursor over the table, the
  2846.      decimal, octal, hexadecimal, and mnemonic values, if appropriate.
  2847.           Further, by moving onto a particular character and hitting
  2848.      return, you will add this character to the string displayed at the
  2849.      top.  You can build a string up to about 30 characters in length.  The
  2850.      <Backspace> key will delete the last character on the string.  When
  2851.      you press <Escape> to leave, the contents of the string will be
  2852.      inserted into the text at the current cursor position.
  2853.  
  2854.      Load_ & Write_profile
  2855.      ---------------------
  2856.           These functions allow you to manage profile files. 
  2857.      'load_profile' will load the profile file for the given extensions,
  2858.      given that it exists.
  2859.           'write_profile' will save the current text settings to the
  2860.      profile file for the named extension.  Further, you will be given the
  2861.      option of saving the file in the current directory (where Bingo looks
  2862.      first) or in Bingo's home directory (where Bingo looks second).
  2863.  
  2864.  
  2865.  
  2866.  
  2867.  
  2868.  
  2869.  
  2870.                           Bingo 2.10e Reference Manual
  2871.                                        46
  2872.  
  2873.  
  2874.  
  2875.  
  2876.      Repeat_last
  2877.      -----------
  2878.           This is a handy function.  It will execute the most-recently-
  2879.      executed function again.  It won't change what that most-recently-
  2880.      executed function was.
  2881.  
  2882.      Display_file
  2883.      ------------
  2884.           Simple, useful.  It will popup the named file into a scrollable
  2885.      window, very similar to the help file.  This would let you create
  2886.      multiple help files.
  2887.  
  2888.      Box Draw Mode
  2889.      -------------
  2890.           This is an enormously useful capability.  When the
  2891.      'toggle_box_draw' function is executed, you will be asked whether you
  2892.      wish to use single or double line drawing.  After you make your
  2893.      choice, the 4 cursor movement functions will respond differently. 
  2894.      When you move the cursor up via the 'cursor_up' function, the cursor
  2895.      will move up, but it will trail a line (of the appropriate mode)
  2896.      behind.  Corners and intersections will be handled automatically.  The
  2897.      line characters will be placed into the text as if Bingo was in
  2898.      overwrite mode. 
  2899.  
  2900.      Cmd_line
  2901.      --------
  2902.           This function gives you a command line entry space on the status
  2903.      line.  You may enter any valid Bingo function.  You only need to enter
  2904.      enough of the function to make it unique; for example, 'swap_ex' is
  2905.      enough to get you the swap_execute function.
  2906.           Further, you can pass parameters to the function you enter
  2907.      directly on the command line, provided the parameters would normally
  2908.      be entered into a string-entry box.  For example,
  2909.  
  2910.           swap_exec dir/p
  2911.  
  2912.      entered in response to the cmd_line would directly execute the "dir/p"
  2913.      command after swapping Bingo out.
  2914.           Note that this only works for parameters which would normally be
  2915.      entered in a string-entry box; parameters entered in response to a
  2916.      Yes/No box would not work.
  2917.  
  2918.  
  2919.  
  2920.  
  2921.  
  2922.  
  2923.  
  2924.  
  2925.  
  2926.  
  2927.  
  2928.                           Bingo 2.10e Reference Manual
  2929.                                        47
  2930.  
  2931.  
  2932.  
  2933.  
  2934.                                 System Operations
  2935.                                 -----------------
  2936.  
  2937.           Bingo supports a number of system operations.  While they are not
  2938.      large in number, they are large in utility.
  2939.  
  2940.      Changing Directories
  2941.      --------------------
  2942.           The 'chdir' function will allow you to change the currently
  2943.      logged directory, or even drive.  Not used often, but when it is
  2944.      needed, it tends to be *really* needed.
  2945.  
  2946.      Simple Execution & Shelling
  2947.      ---------------------------
  2948.           The 'exec_command' function simply executes a given DOS command
  2949.      line and returns.  It does not do anything fancy, and Bingo will
  2950.      remain in memory (consuming quite a bit of memory) but it is fast and
  2951.      simple for issuing short commands.
  2952.           The 'shell' function is identical to 'exec_command', except it
  2953.      takes no arguments.  It simply gives you a DOS shell.
  2954.  
  2955.      Swap Execution & Shelling
  2956.      -------------------------
  2957.           More often than not, particularly in the case of executing
  2958.      command-line compilers, you simply can't afford to let Bingo hang
  2959.      around in memory, since it consumes a bit.  So Bingo provides two
  2960.      other methods for executing commands.  While they appear identical in
  2961.      form and function to the previous pair of functions, 'swap_execute' &
  2962.      'swap_shell', are much more interesting.  
  2963.           While they, too, execute a command or shell to DOS, prior to
  2964.      doing so, they save all relevant information such as copies of the
  2965.      current files, etc., then swap Bingo out of memory.  When this
  2966.      happens, the ~4k kernel of BE.COM is left behind to manage things in
  2967.      Bingo's absence.  When the command is terminated, Bingo will reappear,
  2968.      load all the state info saved previously, and for all intents and
  2969.      purposes, you are right where you left off.  You can define macros
  2970.      across this gap, your placemarks stay intact, etc.  
  2971.           The cost is a small bit of speed when Bingo saves the state
  2972.      information and reads it again later, but it is negligible for the
  2973.      performance return.  It is ideal for running command-line compilers
  2974.      and other memory intensive programs from within Bingo.
  2975.           One thing to remember: the size of your paste buffers as well as
  2976.      the size of your undo stack affect the time it takes to save and
  2977.      restore Bingo's status.  Keep this in mind when you are configuring
  2978.      the stack size, and when you are utilizing multiple paste buffers.
  2979.           In versions prior to 1.1b, Bingo would not swap shell properly on
  2980.      some machines while running DOS 4.00 and higher.  This has been
  2981.      rectified.
  2982.  
  2983.  
  2984.  
  2985.  
  2986.                           Bingo 2.10e Reference Manual
  2987.                                        48
  2988.  
  2989.  
  2990.  
  2991.  
  2992.           If your machine should for some reason have to be reset while
  2993.      Bingo is swapped out (something that happens when you are developing
  2994.      software), the next time you start Bingo, it will treat the swap files
  2995.      as if they were suspension files, and restore Bingo to its previous
  2996.      state.  
  2997.  
  2998.  
  2999.  
  3000.  
  3001.  
  3002.  
  3003.  
  3004.  
  3005.  
  3006.  
  3007.  
  3008.  
  3009.  
  3010.  
  3011.  
  3012.  
  3013.  
  3014.  
  3015.  
  3016.  
  3017.  
  3018.  
  3019.  
  3020.  
  3021.  
  3022.  
  3023.  
  3024.  
  3025.  
  3026.  
  3027.  
  3028.  
  3029.  
  3030.  
  3031.  
  3032.  
  3033.  
  3034.  
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040.  
  3041.  
  3042.  
  3043.  
  3044.                           Bingo 2.10e Reference Manual
  3045.                                        49
  3046.  
  3047.  
  3048.  
  3049.  
  3050.                                      Macros
  3051.                                      ------
  3052.  
  3053.           Bingo provides tremendous support for the creation, management,
  3054.      and execution of keyboard macros.  This level is support was indicated
  3055.      by the author's own experience in developing Bingo.  
  3056.           I started using Bingo to develop Bingo very early on in Bingo's
  3057.      life (it didn't even have a search function at the time; horrible!) in
  3058.      the hopes that this would ferret out bugs more quickly than testing
  3059.      would.  However, one of the things I missed from my previous editor
  3060.      was the ability to define and replay macros on the fly.  In addition,
  3061.      I felt my previous editor was missing some key functionality when it
  3062.      came to dealing with the keyboard, so I had the opportunity to "do
  3063.      macros right".  Of course, my definition of useful macros may differ
  3064.      from yours, but...
  3065.  
  3066.                !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  3067.                !!!!                                       !!!!
  3068.                !!!! Macros from versions prior to 2.0 are !!!!
  3069.                !!!!                  not                  !!!!
  3070.                !!!! compatible with version 2.0 and above !!!!
  3071.                !!!!                                       !!!!
  3072.                !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  3073.  
  3074.           As of version 2.01, Bingo retains the status of the last function
  3075.      executed internally as a True or False value; you can see this
  3076.      reflected on the far right end of the active status line.  If, during
  3077.      the execution of a macro a function returns a False value, the macro
  3078.      will terminate.  Further, if applicable, the repeat command will
  3079.      terminate.  This allows you to execute macros "until function failure"
  3080.      based on things like trying to move beyond the beginning of the line.
  3081.  
  3082.      Macro Space
  3083.      -----------
  3084.           Prior to version 2.10, Binge restricted macro space to 2048 macro
  3085.      tokens and 200 key combinations.  With version 2.10, these limits have
  3086.      been removed.  Bingo will dynamically increase its macro space to
  3087.      compensate when you add or release memory.  Thus, macro space is
  3088.      limited by available memory.
  3089.  
  3090.      Defining Macros
  3091.      ---------------
  3092.           There are three ways to define macros, all very similar.  You can
  3093.      define the scrap key to hold a macro, a single key to hold a macro, or
  3094.      a two key combination to hold a macro.  Any of these functions will
  3095.      also end a macro definition if one is currently in progress.
  3096.  
  3097.  
  3098.  
  3099.  
  3100.  
  3101.  
  3102.                           Bingo 2.10e Reference Manual
  3103.                                        50
  3104.  
  3105.  
  3106.  
  3107.  
  3108.           Macros can be defined across any number of activities.  Pressing
  3109.      <Escape> at any time as the response to a query from Bingo will end
  3110.      the macro presently being recorded.
  3111.  
  3112.      Saving Macros
  3113.      -------------
  3114.           Using the single key save and load functions, you can save
  3115.      favorite macros to named files for later recall.  Single saving also
  3116.      saves the key sequence the macro is attached to, and loading it in
  3117.      again will redefine the key.
  3118.  
  3119.      Saving the Entire Key Set
  3120.      -------------------------
  3121.           Bingo also allows you to save the entire key table, including all
  3122.      key assignments and all macros, for later recall.  Recalling a keyset
  3123.      file will overwrite the entire key table, so be warned.  
  3124.           When you save a keyset file, you can name the keyset file, and
  3125.      you can have it saved in Bingo's home directory or in an arbitrary
  3126.      directory.  If you name it Keycfg.set, it becomes the default file
  3127.      keyset, depending where you put it.  When Bingo starts up, it looks
  3128.      first in the current directory, then in its home directory for
  3129.      KEYCFG.SET.  This allows you to have multiple key configurations in
  3130.      different disk locations while still maintaining one executable.
  3131.  
  3132.      Executing a Macro File
  3133.      ----------------------
  3134.           You may also execute any macro which was single saved to a file
  3135.      at any time.  This executes it one, without disturbing the current key
  3136.      table assignments.  Good for macros used infrequently, but which are
  3137.      very useful.  I have a whole library of interesting ones saved at this
  3138.      point.
  3139.  
  3140.  
  3141.  
  3142.  
  3143.  
  3144.  
  3145.  
  3146.  
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.                           Bingo 2.10e Reference Manual
  3161.                                        51
  3162.  
  3163.  
  3164.  
  3165.  
  3166.                                      Windows
  3167.                                      -------
  3168.  
  3169.      Window_split, _edit & _load
  3170.      ---------------------------
  3171.            These three functions create new windows from the current
  3172.      window.  Window_split simply splits the current window into two, both
  3173.      containing the same file.
  3174.           Window_edit essentially performs a split, then executes an
  3175.      edit_file function.
  3176.           Window_load essentially performs a split, then a load_file
  3177.      function.
  3178.  
  3179.      Window_vertical
  3180.      ---------------
  3181.           Starting in version 2.0, Bingo provided the ability to split
  3182.      windows vertically.  There are some restrictions, however.  Vertical
  3183.      windows must always exist in pairs; that is, two windows sharing one
  3184.      status line.  They are even resized together.  This is not a large
  3185.      problem, but you should be aware of it.
  3186.  
  3187.      Window_resize
  3188.      -------------
  3189.           This function allows you to change the vertical size of a window,
  3190.      as well as the window below the current one.  
  3191.  
  3192.      Window_one & Window_zoom
  3193.      ------------------------
  3194.           While window_one and window_zoom superficially perform the same
  3195.      action, remember that zoom is simply a toggle, while the 'window_one'
  3196.      function eliminates all windows except the current, growing the
  3197.      current window to full size.
  3198.  
  3199.  
  3200.  
  3201.  
  3202.  
  3203.  
  3204.  
  3205.  
  3206.  
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.                           Bingo 2.10e Reference Manual
  3219.                                        52
  3220.  
  3221.  
  3222.  
  3223.  
  3224.                                     Printing
  3225.                                     --------
  3226.  
  3227.           Prior to version 2.01, there were two functions to print, one for
  3228.      the file and one for a marked block.  As of version 2.01, these have
  3229.      been combined into 'print_file', which prints a block if it is marked,
  3230.      otherwise it prints the file.
  3231.           There are a number of options governing printing.  You can ask
  3232.      for line numbers to be printed, page headers (time, page, filename),
  3233.      and decide whether Bingo should terminate a line with a single
  3234.      linefeed, or with linefeed/carraige return pairs.
  3235.           You can also send standalone linefeed or formfeed character, or
  3236.      send a sequence of ASCII values.
  3237.  
  3238.  
  3239.  
  3240.  
  3241.  
  3242.  
  3243.  
  3244.  
  3245.  
  3246.  
  3247.  
  3248.  
  3249.  
  3250.  
  3251.  
  3252.  
  3253.  
  3254.  
  3255.  
  3256.  
  3257.  
  3258.  
  3259.  
  3260.  
  3261.  
  3262.  
  3263.  
  3264.  
  3265.  
  3266.  
  3267.  
  3268.  
  3269.  
  3270.  
  3271.  
  3272.  
  3273.  
  3274.  
  3275.  
  3276.                           Bingo 2.10e Reference Manual
  3277.                                        53
  3278.  
  3279.  
  3280.  
  3281.  
  3282.                              Error Parsing and Undo
  3283.                              ----------------------
  3284.  
  3285.      How Error Parsing Works
  3286.      -----------------------
  3287.           Bingo provides the capability to automatically parse compiler
  3288.      generated error messages.  The procedure for this is fairly simple.
  3289.           First, you must have a text file containing the error output of
  3290.      the compiler (or assembler) in question.  This usually obtained by
  3291.      running said compiler and redirecting its output to a file.  Bring
  3292.      this file into the editor.
  3293.           Next, call the 'setup_err_parse' function, and give it the name
  3294.      of the file.  If the name matches a file in the ring, Bingo will tell
  3295.      you that error processing is setup properly.
  3296.           Now it is simple; simple call the 'next_error' or 'prev_error'
  3297.      functions.  The following things will happen:
  3298.  
  3299.           1)   Bingo will see if a next (or previous) error can be found. 
  3300.           If not, it will report that no more errors exist.
  3301.           2)   Assuming an error line is found, the filename and line
  3302.           number will be picked out of the line.  Bingo will perform and
  3303.           edit_file operation on the filename, then jump to the offending
  3304.           line.  All of this will happen within the current window.
  3305.           3)   Also, any onscreen window which contains the file being
  3306.           parsed will be updated.  The current error line will be
  3307.           highlighted automatically.
  3308.  
  3309.      As you can see, error parsing is super useful.  For a further example
  3310.      of how it works, see the example macro in the section on the KEYCFG
  3311.      program.
  3312.  
  3313.      Error Parsing Method
  3314.      --------------------
  3315.           Bingo parses error files using a "fuzzy" or "best-guess"
  3316.      algorithm.  It checks each line as follows.
  3317.           First, Bingo attempts to find a valid filename on the line.  The
  3318.      filename must contain a period, and it must have a file extension. 
  3319.      The filename cannot be a .EXE or .COM file, and it may contain the
  3320.      full path specification (new with version 2.10e).
  3321.           After finding such a filename, Bingo verifies that the named file
  3322.      exists on disk or in the current ring.  If it does, Bingo now begins
  3323.      to look for the line number within the error file.  Bingo will look
  3324.      for the first number to follow the filename, and use this as the line
  3325.      number.
  3326.           If both a filename & a line number are found, the line will be
  3327.      recognized as a valid error/warning line. 
  3328.  
  3329.  
  3330.  
  3331.  
  3332.  
  3333.  
  3334.                           Bingo 2.10e Reference Manual
  3335.                                        54
  3336.  
  3337.  
  3338.  
  3339.  
  3340.           This algorithm will work for the Borland and Microsoft
  3341.      developmental tools.  However, in some cases, you may have to consult
  3342.      your manual in order to find what command-line switches have to be set
  3343.      for your compiler to output errors in a usable message format.
  3344.  
  3345.           !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  3346.           !!!!!!!!                                !!!!!!!!!
  3347.           !!!!!!!! Note that linker errors do not !!!!!!!!!
  3348.           !!!!!!!! have line numbers, and so will !!!!!!!!!
  3349.           !!!!!!!!      not be recognized.        !!!!!!!!!
  3350.          !!!!!!!!                                 !!!!!!!!!
  3351.           !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  3352.  
  3353.      However, whenever Bingo encounters a situation where there are no more
  3354.      errors, it will display a message saying so.  Further, it will display
  3355.      a portion of the last non-blank line in the error file on the message
  3356.      line with the "No more Errors" message, so you can verify that all
  3357.      went well.
  3358.  
  3359.      Undo Capabilities
  3360.      -----------------
  3361.           Bingo has several capabilities to allow you to recover from
  3362.      recent mistakes.  The 'Restore_line' function, will simply recall the
  3363.      state of the current line to what it was when you first arrived.  This
  3364.      is good only as long as you do not move from the line; once you leave
  3365.      the line, its original state is lost forever.
  3366.           This type of error-recovery is good for small things, but
  3367.      something more substantial was needed.  So Bingo keeps a stack of
  3368.      recently deleted items; text deleted by 'del_eol', 'del_bol', and
  3369.      'del_line' functions.  This stack is kept in reverse order; that is,
  3370.      the most recently deleted text is placed in top of the undo stack.
  3371.           Additionally, you have an option regarding text cut to the paste
  3372.      buffer.  Normally, when you place text into the paste buffer (Using
  3373.      the 'cut', 'copy', etc. functions), if the paste buffer already
  3374.      contains something, that text is discarded.  However, if you set the
  3375.      'cut to stack' option on (in the General Config Menu, or with the
  3376.      'conf_cut_stack' function), this text will be pushed onto the stack
  3377.      also.
  3378.           You can control the size of the undo stack using the
  3379.      'conf_kill_size' function (1 to 10240 lines), or through the config
  3380.      menus.  You cannot, however, turn it off.
  3381.  
  3382.  
  3383.  
  3384.  
  3385.  
  3386.  
  3387.  
  3388.  
  3389.  
  3390.  
  3391.  
  3392.                           Bingo 2.10e Reference Manual
  3393.                                        55
  3394.  
  3395.  
  3396.  
  3397.  
  3398.      Manipulating the Undo Stack
  3399.      ---------------------------
  3400.           There are three functions available to help you deal with the
  3401.      undo stack.  'rotate_kill' will popup a list of the current stack's
  3402.      contents.  By moving the menu bar and hitting return, you can move the
  3403.      selected entry to the top of the stack.
  3404.           'unkill' and 'paste_kill' are very similar.  They take the top
  3405.      member of the stack and insert it in the current position.  If the top
  3406.      member of the stack was a full line, it will be inserted above the
  3407.      current line.  'unkill' also removes the top member from the stack.
  3408.  
  3409.  
  3410.  
  3411.  
  3412.  
  3413.  
  3414.  
  3415.  
  3416.  
  3417.  
  3418.  
  3419.  
  3420.  
  3421.  
  3422.  
  3423.  
  3424.  
  3425.  
  3426.  
  3427.  
  3428.  
  3429.  
  3430.  
  3431.  
  3432.  
  3433.  
  3434.  
  3435.  
  3436.  
  3437.  
  3438.  
  3439.  
  3440.  
  3441.  
  3442.  
  3443.  
  3444.  
  3445.  
  3446.  
  3447.  
  3448.  
  3449.  
  3450.                           Bingo 2.10e Reference Manual
  3451.                                        56
  3452.  
  3453.  
  3454.  
  3455.  
  3456.                                 Configuring Bingo
  3457.                                 -----------------
  3458.  
  3459.           Bingo is extremely configurable.  To access the configuration
  3460.      menu, select the 'Config' option from the main menu, or attach keys to
  3461.      particular configuration functions.  The settings themselves are
  3462.      explained explicitly in the Function List section of this document in
  3463.      the Configuration portion.  
  3464.           To make the current selections permanent, select the "Write
  3465.      setting" option found on the main configuration menu.
  3466.           There is one item of interest of interest.  There are nine
  3467.      settings which as of version 2.01 are maintained on a per buffer
  3468.      basis.  These settings are the ones saved in profile files, and are
  3469.      found on the 'Text Settings' config menu.  Each time you change these
  3470.      with a 'conf_' function, you change both the underlying default (used
  3471.      when new files are brought in) and the current buffer's settings.  For
  3472.      a few settings, there are also 'toggle_' functions, such as
  3473.      'toggle_cmode'.  These change only the current buffer's settings.
  3474.  
  3475.  
  3476.  
  3477.  
  3478.  
  3479.  
  3480.  
  3481.  
  3482.  
  3483.  
  3484.  
  3485.  
  3486.  
  3487.  
  3488.  
  3489.  
  3490.  
  3491.  
  3492.  
  3493.  
  3494.  
  3495.  
  3496.  
  3497.  
  3498.  
  3499.  
  3500.  
  3501.  
  3502.  
  3503.  
  3504.  
  3505.  
  3506.  
  3507.  
  3508.                           Bingo 2.10e Reference Manual
  3509.                                        57
  3510.  
  3511.  
  3512.  
  3513.  
  3514.                                   Function List
  3515.                                   -------------
  3516.  
  3517.           The following section contains a listing of the functions
  3518.      supported by Bingo, grouped by functionality.  The index at the end of
  3519.      this document makes alphabetical location of these functions simple.
  3520.  
  3521.      General Editing
  3522.      ---------------
  3523.  
  3524.      - insert_tab
  3525.           insert the number of spaces needed to move the cursor to the next
  3526.           tab stop, based on the current tabsize.
  3527.  
  3528.      - carriage
  3529.           splits the current line by moving the cursor to the start of the
  3530.           next line, taking everything to the right of the cursor along for
  3531.           the ride.  If this moves you onto the bottom line of the window,
  3532.           the line will be centered on the screen.  Depending on C mode and
  3533.           the AutoIndent mode settings, automatic indentation of some type
  3534.           may be performed.
  3535.  
  3536.      - toggle_ins
  3537.           toggles the insert/overwrite mode. Changes only the setting of
  3538.           the current buffer.
  3539.  
  3540.      - toggle_wrap
  3541.           toggles the word wrap setting. Changes only the setting of the
  3542.           current buffer.
  3543.  
  3544.      - toggle_cmode
  3545.           toggles the C mode setting, regardless of the file name. Changes
  3546.           only the setting of the current buffer.
  3547.  
  3548.      - toggle_autoindent
  3549.           toggle the autoindent setting.  Changes only the setting of the
  3550.           current buffer.
  3551.  
  3552.      - main_menu
  3553.           invokes the main menu.
  3554.  
  3555.      - del_char
  3556.           deletes the current character at the cursor position; if it was
  3557.           at the end of a line, brings the next line up.
  3558.  
  3559.      - back_space
  3560.           performs a destructive backspace, based on the current deletion
  3561.           mode in effect.
  3562.  
  3563.  
  3564.  
  3565.  
  3566.                           Bingo 2.10e Reference Manual
  3567.                                        58
  3568.  
  3569.  
  3570.  
  3571.  
  3572.      - del_line
  3573.                deletes the entire current line, regardless of position.
  3574.  
  3575.      - del_eol
  3576.                deletes all text to the end of the line; if at the end of a
  3577.                line, joins the lines.
  3578.      - del_bol
  3579.                deletes all text to beginning of line, moves to first
  3580.                column. If at the beginning, joins the line with the
  3581.                previous line.
  3582.  
  3583.      - default_del
  3584.           does one of two things depending on whether or not a block is
  3585.           marked.  If a block is marked, the 'cut' function is executed. 
  3586.           If no block is marked, the 'del_char' function is executed.
  3587.  
  3588.      - default_bspace
  3589.           similar to 'default_del', except that if no block is marked, a
  3590.           'back_space' function is executed.
  3591.  
  3592.      - del_word_rt
  3593.           deletes from the current cursor position to the start of the next
  3594.           word to the right.
  3595.  
  3596.      - del_word_lt
  3597.           deletes from the current cursor position to the start of the next
  3598.           word to the left.
  3599.  
  3600.  
  3601.  
  3602.  
  3603.  
  3604.  
  3605.  
  3606.  
  3607.  
  3608.  
  3609.  
  3610.  
  3611.  
  3612.  
  3613.  
  3614.  
  3615.  
  3616.  
  3617.  
  3618.  
  3619.  
  3620.  
  3621.  
  3622.  
  3623.  
  3624.                           Bingo 2.10e Reference Manual
  3625.                                        59
  3626.  
  3627.  
  3628.  
  3629.  
  3630.      File Handling
  3631.      -------------
  3632.  
  3633.      - edit_file
  3634.           after asking for a filename; if the file is already in the ring,
  3635.           it simply switches to it.  If it is not in the ring, it loads the
  3636.           file.
  3637.  
  3638.      - choose_file
  3639.           pops up a list of current files in the ring, and an option for a
  3640.           new file.  Selecting the New File option performs an 'edit_file'
  3641.           function.
  3642.  
  3643.      - load_file
  3644.           after asking for a filename, it loads that file from disk.  If
  3645.           the file is already in the ring, the in-memory version is first
  3646.           deleted from memory.
  3647.  
  3648.      - rename_file
  3649.           renames current file.
  3650.  
  3651.      - switch_file
  3652.           switches to a different file, performing a quit on the current
  3653.           file first.  If you escape out of the quit option, the switch
  3654.           operation will abort.
  3655.  
  3656.      - save_file
  3657.           saves the current file; does not exit.
  3658.  
  3659.      - modify_save
  3660.           saves current file ONLY if it has been modified.
  3661.  
  3662.      - quit
  3663.           exits current file.  If the file was modified, it will ask you if
  3664.           you wish to save the file; a <return> indicates yes.
  3665.  
  3666.      - abort
  3667.           exits the file, no protection, no save.
  3668.  
  3669.      - file
  3670.           saves and exits current file.
  3671.  
  3672.      - next_file
  3673.           moves to the next file in ring.
  3674.  
  3675.      - prev_file
  3676.           moves to the previous file in the ring.
  3677.  
  3678.      - quit_all
  3679.           performs a quit on each file in the ring.
  3680.  
  3681.  
  3682.                           Bingo 2.10e Reference Manual
  3683.                                        60
  3684.  
  3685.  
  3686.  
  3687.  
  3688.      - abort_all
  3689.           aborts all files, no questions asks.
  3690.  
  3691.      - file_all
  3692.           saves and exits all files.
  3693.  
  3694.      - save_all
  3695.           saves all files.
  3696.  
  3697.      - modify_save_all
  3698.           saves each modified file in the ring.
  3699.  
  3700.      - delete_file
  3701.           asks for a filename to delete on disk.
  3702.  
  3703.      - zap_file
  3704.           delete's the disk copy of the current file. 
  3705.  
  3706.      - block_load
  3707.           loads a file into the current position
  3708.  
  3709.      - clean_file
  3710.           resets the 'modified' status of the file to FALSE.
  3711.  
  3712.      - clean_all
  3713.           resets the 'modified' status of all files in the ring to FALSE.
  3714.  
  3715.      - backup_file
  3716.           forces a backup attempt for the current file; this will only have
  3717.           an effect if the file's timed backup setting is on.
  3718.  
  3719.      - backup_all
  3720.           forces a backup attempt on each file in the ring.  For each file,
  3721.           this will only have an effect if the file's timed backup setting
  3722.           is on.
  3723.  
  3724.  
  3725.  
  3726.  
  3727.  
  3728.  
  3729.  
  3730.  
  3731.  
  3732.  
  3733.  
  3734.  
  3735.  
  3736.  
  3737.  
  3738.  
  3739.  
  3740.                           Bingo 2.10e Reference Manual
  3741.                                        61
  3742.  
  3743.  
  3744.  
  3745.  
  3746.      Searching
  3747.      ---------
  3748.  
  3749.      - again
  3750.           repeat the last search operation.  If none has yet been done,
  3751.           works just like search.  If the last search operation done was a
  3752.           search & replace, only the search portion is done.
  3753.  
  3754.      - search
  3755.           search for text.  Will ask for the target text, and two
  3756.           modifiers:
  3757.                               I Ignore case
  3758.                               B Backwards
  3759.                               C Count
  3760.                               R Regexp
  3761.                               A Accent
  3762.           The 'C' option simply counts the number of occurrences.
  3763.           The 'R' option tells Bingo to interpret the input string as a
  3764.           regular expression.  See the section on searching and the READ.ME
  3765.           file for more details.
  3766.           The 'A' option tells Bingo to highlight the 'found' text until
  3767.           the next keystroke arrives.
  3768.           If the text is marked, the marking will be treated as
  3769.           linemarking, and Bingo's search will not continue past the end of
  3770.           the marked area.  This allows you to limit the searching scope to
  3771.           a particular area.
  3772.  
  3773.  
  3774.  
  3775.  
  3776.  
  3777.  
  3778.  
  3779.  
  3780.  
  3781.  
  3782.  
  3783.  
  3784.  
  3785.  
  3786.  
  3787.  
  3788.  
  3789.  
  3790.  
  3791.  
  3792.  
  3793.  
  3794.  
  3795.  
  3796.  
  3797.  
  3798.                           Bingo 2.10e Reference Manual
  3799.                                        62
  3800.  
  3801.  
  3802.  
  3803.  
  3804.      - replace
  3805.           search and replace text.  Will ask for target, replacement text,
  3806.           and three modifiers:
  3807.                               I Ignore Case
  3808.                               B Backwards
  3809.                               G Global Search/Replace
  3810.                               R Regexp
  3811.                               A Accent
  3812.                               P Preserve
  3813.                               D Debug
  3814.           If Global is selected, Bingo will simply replace all matching
  3815.           occurrences with the replacement text.  If not, Bingo will stop
  3816.           at each match and ask:
  3817.                               Yes:      replace and continue.
  3818.                               No:       don't replace, but continue search.
  3819.                               Only:     Replace this and stop
  3820.                               Quit:     stop, no replacement.
  3821.                               Global:   Continue with global replacement
  3822.           'R' & 'A' options work as in the search case.
  3823.           'P' tells Bingo to preserve the original cursor location and
  3824.           return to it when done with the replace operation.
  3825.           'D' is useful for regular expression work.  It tells Bingo to
  3826.           display its conception of the target string (grouping, classes,
  3827.           occurance, etc).
  3828.           Marked text limits the range as in the search function.
  3829.  
  3830.      - search_macro
  3831.           will acted like the 'search' function, but will ask for a key to
  3832.           apply when found.  It will work like the replace function, but
  3833.           instead of replacing, it will execute the given key.  DO NOT use
  3834.           this function while recording a macro.
  3835.  
  3836.      - mark_last_found
  3837.           his will unmark the file and mark the last found text if you have
  3838.           not moved.
  3839.  
  3840.      - leap_forward
  3841.           searches forward for the next occurence of the next key pressed. 
  3842.           If the key is a function key or return, 'leap_forward' will use
  3843.           the previous target.
  3844.  
  3845.      - leap_backward
  3846.           searches backward for the next occurence of the next key pressed. 
  3847.           If the key is a function key or return, 'leap_backward' will use
  3848.           the previous target.
  3849.  
  3850.  
  3851.  
  3852.  
  3853.  
  3854.  
  3855.  
  3856.                           Bingo 2.10e Reference Manual
  3857.                                        63
  3858.  
  3859.  
  3860.  
  3861.  
  3862.      Navigation
  3863.      ----------
  3864.  
  3865.      - down_page
  3866.           moves down one windowful.
  3867.  
  3868.      - up_page
  3869.           moves up one windowful.
  3870.  
  3871.      - cursor_right
  3872.           moves right one char; wraps if necessary and if bounce mode is
  3873.           active.
  3874.  
  3875.      - cursor_left
  3876.           moves left one char, wraps if necessary and if bounce mode is
  3877.           active.
  3878.  
  3879.      - cursor_up
  3880.           moves up one line.
  3881.  
  3882.      - cursor_down
  3883.           moves down one line.
  3884.  
  3885.      - back_tab
  3886.           moves back to the previous tab stop.  Does not change the text at
  3887.           all.
  3888.  
  3889.      - begin_line
  3890.           goes to beginning of line.
  3891.  
  3892.      - end_line
  3893.           goes to end of line.
  3894.  
  3895.      - top_of_file
  3896.           jump to top of file.
  3897.  
  3898.      - bot_of_file
  3899.           jump to bottom of file.
  3900.  
  3901.      - next_word
  3902.           goes to beginning of next word.
  3903.  
  3904.      - prev_word
  3905.           goes to beginning of previous word.
  3906.  
  3907.      - top_of_screen
  3908.           jumps to the top of screen.
  3909.  
  3910.      - bottom_of_screen
  3911.           jumps to the bottom of screen.
  3912.  
  3913.  
  3914.                           Bingo 2.10e Reference Manual
  3915.                                        64
  3916.  
  3917.  
  3918.  
  3919.  
  3920.      - top_of_block
  3921.           jumps to the top of marked block.
  3922.  
  3923.      - bottom_of_block
  3924.           jumps to the bottom of marked block.
  3925.  
  3926.      - jump
  3927.           jump to position.  If the number is prefaced with a '+'
  3928.           character, Bingo will jump the relative distance forward.  If the
  3929.           number is prefaced with a '-' character, Bingo will jump the
  3930.           relative distance backwards.
  3931.  
  3932.      - center_line
  3933.           makes the current line the center line of the current window, and
  3934.           repaint the entire screen, all windows.  
  3935.  
  3936.      - begin_of_text
  3937.           moves the cursor to the first non-space character on the current
  3938.           line.
  3939.  
  3940.      - indent_up
  3941.           moves to previous line with same indentation scheme as current
  3942.           line.
  3943.  
  3944.      - indent_down
  3945.           moves to next line with same indentation scheme as current line.
  3946.  
  3947.      - snap_to_mouse_xy
  3948.           moves the cursor to the current mouse position, changing windows
  3949.           if necessary.
  3950.  
  3951.      - mouse_scroll
  3952.           moves the cursor to the mouse position when the mouse button is
  3953.           released;  while the button is depressed, the file will scroll up
  3954.           and down, depending on where the mouse cursor is moved.  The
  3955.           closer the cursor is to the top and bottom of the window, the
  3956.           faster the file will scroll.
  3957.  
  3958.      - place_mark
  3959.           drops a placemark, inquiring as which of the 10 allowed (0-9) you
  3960.           are concerned with.  Each placemark contains the filename, the
  3961.           line, the column.
  3962.  
  3963.      - jump_mark
  3964.           jumps to the specified placemark.  If the specified filename is
  3965.           not in the ring, Bingo will go and get it.
  3966.  
  3967.      - show_marks
  3968.           pops up a window showing the current placemarks in effect for
  3969.           this editing session.
  3970.  
  3971.  
  3972.                           Bingo 2.10e Reference Manual
  3973.                                        65
  3974.  
  3975.  
  3976.  
  3977.  
  3978.      - scroll_up
  3979.           scroll the display up one line, keeping the cursor in its same
  3980.           place.
  3981.  
  3982.      - scroll_down
  3983.           scroll the display down one line, keeping the cursor in its same
  3984.           place.
  3985.  
  3986.      - scroll_left
  3987.           scrolls the screen to left (the text to the right). 
  3988.  
  3989.      - scroll_right
  3990.           scrolls the screen to right (the txt to the left).
  3991.  
  3992.  
  3993.  
  3994.  
  3995.  
  3996.  
  3997.  
  3998.  
  3999.  
  4000.  
  4001.  
  4002.  
  4003.  
  4004.  
  4005.  
  4006.  
  4007.  
  4008.  
  4009.  
  4010.  
  4011.  
  4012.  
  4013.  
  4014.  
  4015.  
  4016.  
  4017.  
  4018.  
  4019.  
  4020.  
  4021.  
  4022.  
  4023.  
  4024.  
  4025.  
  4026.  
  4027.  
  4028.  
  4029.  
  4030.                           Bingo 2.10e Reference Manual
  4031.                                        66
  4032.  
  4033.  
  4034.  
  4035.  
  4036.      Block Handling
  4037.      --------------
  4038.  
  4039.      - line_mark
  4040.           drop a line marker.  The block will be expanded or shrunk,
  4041.           depending on the last drop made.  Line marks consider the line to
  4042.           be the smallest markable element of text.
  4043.  
  4044.      - point_mark
  4045.           drop a point marker.  The block will be expanded or shrunk,
  4046.           depending on the last drop made.  Point marks consider the
  4047.           character to be the smallest markable element of text.
  4048.  
  4049.      - vertical_mark
  4050.           drop a vertical marker. Vertical, or column, blocks are defined
  4051.           by and upper and an opposing lower corner.
  4052.  
  4053.      - extend_mark
  4054.           extends the current marked block, using whichever marking scheme
  4055.           is in place.  Does nothing if no block is marked.
  4056.  
  4057.      - unmark
  4058.           unmark all text in current buffer.
  4059.  
  4060.      - cut
  4061.           cut the marked text to the block buffer.  The marked text is
  4062.           deleted from the file.  
  4063.  
  4064.      - copy
  4065.           copy the marked text to the block buffer.  The marked text is NOT
  4066.           deleted from the file.
  4067.  
  4068.      - paste
  4069.           pastes the contents of the block buffer into the text at the
  4070.           current position.  If the contents were linemarked, the contents
  4071.           will be pasted, as lines, above the current line.  
  4072.  
  4073.      - paste_replace
  4074.           pastes the contents of the block buffer at the current location,
  4075.           overwriting the needed amount of space.  This is only valid when
  4076.           the paste buffer is Line or Vertical marked.
  4077.  
  4078.      - block_move
  4079.           moves the currently marked blocked of text to the cursor
  4080.           position.
  4081.  
  4082.      - block_copy
  4083.           copies the currently marked blocked of text to the cursor
  4084.           position.
  4085.  
  4086.  
  4087.  
  4088.                           Bingo 2.10e Reference Manual
  4089.                                        67
  4090.  
  4091.  
  4092.  
  4093.  
  4094.      - block_delete
  4095.           deletes the currently marked block of text to the block buffer;
  4096.           identical to cut.
  4097.  
  4098.      - block_save
  4099.           writes the currently marked text to a file.
  4100.  
  4101.      - swap_buf_and_block
  4102.           takes the currently marked portion, and swaps it with the current
  4103.           contents of the paste buffer.  The two blocks need not be of the
  4104.           same type.
  4105.  
  4106.      - report_bsize
  4107.           reports the number of lines and characters (line breaks in point
  4108.           marked blocks count as one character) the currently marked block
  4109.           spans.
  4110.  
  4111.      - name_buffer
  4112.           allows you to change the current paste buffer.  <return>
  4113.           specifies the default buffer, and 'a'-'z' specify their
  4114.           respective buffers.
  4115.  
  4116.      - buffer_info
  4117.           displays various pertinent information about all the paste
  4118.           buffers.
  4119.  
  4120.      - look_buffer
  4121.           displays the contents of the current buffer in a non-editable
  4122.           window.  This only displays up to the first 100 lines in the
  4123.           buffer.
  4124.  
  4125.      - cut_append
  4126.           works exactly like 'Cut', except it appends the marked text to
  4127.           the current contents of the buffer.  The text in the buffer and
  4128.           the marked text must be of the same type.
  4129.  
  4130.      - copy_append
  4131.           just as 'Cut_append', but performs a copy instead.
  4132.  
  4133.      - emacs_yank
  4134.           melds the unkill stack and the paste buffer together.  If the
  4135.           most recent block operation/deletion was a block operation,
  4136.           'emacs_yank' works exactly like 'paste', pushing the paste buffer
  4137.           contents into the text.  If the most recent operation was a
  4138.           deletion (word, line, -eol, -bol), 'emacs_yank' works like the
  4139.           'paste_kill' function, pulling text from the undo stack without
  4140.           disturbing its contents.  This allows you to use the deletion
  4141.           commands to manipulate text in concert with the paste buffer
  4142.           operations.
  4143.  
  4144.  
  4145.  
  4146.                           Bingo 2.10e Reference Manual
  4147.                                        68
  4148.  
  4149.  
  4150.  
  4151.  
  4152.      Utilities
  4153.      ---------
  4154.  
  4155.      - entab
  4156.           compresses the linemarked region specified or the entire file by
  4157.           converting spaces to tabs.
  4158.  
  4159.      - indent_tab
  4160.           compresses the leading spaces of the linemark region specified or
  4161.           the entire file by converting into the proper tabs.  Rounds to
  4162.           the nearest tab stop, thus "normalizing" the indention to tab
  4163.           stops.
  4164.  
  4165.      - detab
  4166.           expands the linemarked region specified or the entire file by
  4167.           converting tabs to spaces.
  4168.  
  4169.      - shift_block
  4170.           shifts the specified linemarked region the number of columns
  4171.           specified.  Positive numbers indicate right-shifting, negative
  4172.           numbers, left-shifting.  The character 't' is used to signify tab
  4173.           widths '-3t' shifts the block left 3 tabwidths.
  4174.  
  4175.      - lcase_block
  4176.           lowercases the linemarked region.
  4177.  
  4178.      - ucase_block
  4179.           uppercases the linemarked region.
  4180.  
  4181.      - fcase_block
  4182.           flips the case of the linemarked region.
  4183.  
  4184.      - word_count
  4185.           counts the words in the linemarked region, default the whole
  4186.           file.  A word here is defined as non-whitespace and non-
  4187.           punctuation characters, NOT by the settings of the 'conf_word'
  4188.           function.
  4189.  
  4190.      - strip_highbit
  4191.           strips the 8th bit in the linemarked region, default the whole
  4192.           file.
  4193.  
  4194.      - sort_block
  4195.           sorts block, ascending or descending, on a certain column.
  4196.  
  4197.      - reform_para
  4198.           reformats a block of text to conform to the right margin; a
  4199.           paragraph is defined as text between blank lines.  The total
  4200.           amount of text contained in a single paragraph cannot be larger
  4201.           than 30000 characters.
  4202.  
  4203.  
  4204.                           Bingo 2.10e Reference Manual
  4205.                                        69
  4206.  
  4207.  
  4208.  
  4209.  
  4210.      - repeat
  4211.           repeats a keystroke n times.  If n is '*', the function repeats
  4212.           until a search fails.  The function halts repetition on a search
  4213.           failure.  DO NOT use this command while you are recording a
  4214.           macro; you will get unpredictable results.
  4215.  
  4216.      - dup_line
  4217.           duplicates the current line and increments cursor to the next
  4218.           line.
  4219.  
  4220.      - align
  4221.           slides the linemarked region left or right to match indentation
  4222.           with the line immediately above the first marked line.  If not
  4223.           lines are marked, the current line is aligned.
  4224.  
  4225.      - match_delim
  4226.           finds the proper match for a delimiter.  Delimiters include
  4227.           'begin'/'end' to help Pascal programmers, as well as '({[<'.
  4228.  
  4229.      - time_stamp
  4230.           inserts the current date and time into the text.
  4231.  
  4232.      - fill_block
  4233.           fills a vertically marked block with a specified character.
  4234.  
  4235.      - center_text
  4236.           centers the current non-space text of the current line (or
  4237.           linemarked block) on its line, relative to the right margin.
  4238.  
  4239.  
  4240.  
  4241.  
  4242.  
  4243.  
  4244.  
  4245.  
  4246.  
  4247.  
  4248.  
  4249.  
  4250.  
  4251.  
  4252.  
  4253.  
  4254.  
  4255.  
  4256.  
  4257.  
  4258.  
  4259.  
  4260.  
  4261.  
  4262.                           Bingo 2.10e Reference Manual
  4263.                                        70
  4264.  
  4265.  
  4266.  
  4267.  
  4268.      Extra Operations
  4269.      ----------------
  4270.  
  4271.      - help
  4272.           views the help file BINGO.HLP.  This file must be located in the
  4273.           same directory as BE.EXE.
  4274.  
  4275.      - info
  4276.           pops up an info window, providing information on current files in
  4277.           the ring, and about Bingo's current condition
  4278.  
  4279.      - pick_exec
  4280.           this allows you to pick a function descriptor and have it
  4281.           executed.
  4282.  
  4283.      - quit_and_save_status
  4284.           his function saves the current status of Bingo as well as the
  4285.           current files, so that the next time Bingo is invoked, you will
  4286.           be given the option to pick up where you left off.
  4287.  
  4288.      - global
  4289.           this allows you to execute any keystroke globally, throughout all
  4290.           the files in the ring.  DO NOT use this function while recording
  4291.           a macro.
  4292.  
  4293.      - query_quote
  4294.           inserts an integer or sequence of integers as its raw ASCII
  4295.           character.  The decimal values must be comma delimited.
  4296.  
  4297.      - ascii_table
  4298.           pops up a display of all Ascii characters.  By hitting Return on
  4299.           a character, you add it to the string.  When you hit Escape, the
  4300.           string is inserted into the text. 
  4301.  
  4302.      - toggle_display
  4303.           toggles the display size between 25 lines and 43/50 lines.  Will
  4304.           in all likelihood screw up the cursor shape, since the scan line
  4305.           counts will change.
  4306.  
  4307.      - load_profile
  4308.           loads the profile file of your choice, searching first the
  4309.           current directory then Bingo's home directory.  Prompts to see if
  4310.           you wish to load a keyset file.
  4311.  
  4312.  
  4313.  
  4314.  
  4315.  
  4316.  
  4317.  
  4318.  
  4319.  
  4320.                           Bingo 2.10e Reference Manual
  4321.                                        71
  4322.  
  4323.  
  4324.  
  4325.  
  4326.      - write_profile
  4327.           saves the text settings of the active buffer to the profile file
  4328.           of your choice in either the current directory or Bingo's home
  4329.           directory.  Settings include:
  4330.  
  4331.                          &ins=1     (insert mode, 1=yes, 0=no)
  4332.                          &tabs=5    (tabsize)
  4333.                          &wrap=1    (wordwrap, 1=yes, 0=no)
  4334.                          &indent=1  (autoindention mode, 1=yes, 0=no)
  4335.                          &cmode=0   (C mode, 0=off, 1=mode 1, etc)
  4336.                          &rmarg=65  (right margin)
  4337.                          &smart=0   (smart tabs, 1=yes, 0=no)
  4338.                          &match=0   (matching mode, 1=yes, 0=no)
  4339.                          &bspace=0  (backspace mode)
  4340.                          &timed=256 (timed backups, range 0 - 32000)
  4341.       
  4342.      - version_info
  4343.           displays various version information and the name of the person
  4344.           this copy was registered to, if it is a registered copy.
  4345.  
  4346.      - repeat_last
  4347.           repeats the last function executed.  
  4348.  
  4349.      - display_file
  4350.           will popup the named file into a scrollable box, similar to the
  4351.           help file.
  4352.  
  4353.  
  4354.  
  4355.  
  4356.  
  4357.  
  4358.  
  4359.  
  4360.  
  4361.  
  4362.  
  4363.  
  4364.  
  4365.  
  4366.  
  4367.  
  4368.  
  4369.  
  4370.  
  4371.  
  4372.  
  4373.  
  4374.  
  4375.  
  4376.  
  4377.  
  4378.                           Bingo 2.10e Reference Manual
  4379.                                        72
  4380.  
  4381.  
  4382.  
  4383.  
  4384.      System Operations
  4385.      -----------------
  4386.  
  4387.      - chdir
  4388.           change the currently logged directory.
  4389.  
  4390.      - exec_command
  4391.           execute a DOS command, while leaving Bingo completely resident in
  4392.           memory.
  4393.  
  4394.      - shell
  4395.           shell to DOS, leaving Bingo completely resident in memory.
  4396.  
  4397.      - swap_execute
  4398.           execute a DOS command while swapping Bingo out.  This will cause
  4399.           Bingo to save copies of the buffers as well as state information,
  4400.           and leave behind an ~10k kernel.
  4401.  
  4402.      - swap_shell
  4403.           shell to DOS while swapping as above.
  4404.  
  4405.  
  4406.  
  4407.  
  4408.  
  4409.  
  4410.  
  4411.  
  4412.  
  4413.  
  4414.  
  4415.  
  4416.  
  4417.  
  4418.  
  4419.  
  4420.  
  4421.  
  4422.  
  4423.  
  4424.  
  4425.  
  4426.  
  4427.  
  4428.  
  4429.  
  4430.  
  4431.  
  4432.  
  4433.  
  4434.  
  4435.  
  4436.                           Bingo 2.10e Reference Manual
  4437.                                        73
  4438.  
  4439.  
  4440.  
  4441.  
  4442.      Macros
  4443.      ------
  4444.  
  4445.           !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  4446.           !!!!!                                         !!!!!
  4447.           !!!!! All of these functions will end a macro !!!!!
  4448.           !!!!!        being currently defined          !!!!!
  4449.           !!!!!                                         !!!!!
  4450.           !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  4451.  
  4452.      - define_scrap
  4453.           start scrap macro definition.  
  4454.  
  4455.      - onekey_def
  4456.           start single-key macro definition.
  4457.  
  4458.      - twokey_def
  4459.           start two-key macro definition.
  4460.  
  4461.      - scrap
  4462.           execute the scrap macro.
  4463.  
  4464.      - single_key_save
  4465.           save a single macro to a file for later recall.  Saves the key it
  4466.           is attached to also.
  4467.  
  4468.      - single_key_load
  4469.           load a single macro from a file.  Overwrites the current
  4470.           definition for the key, if it has one.
  4471.  
  4472.      - key_set_save
  4473.           saves entire keyset, including macros, but not the scrap.
  4474.  
  4475.      - key_set_load
  4476.           load entire keyset.
  4477.  
  4478.      - run_macro_file
  4479.           runs a macro from a file saved with single_key_save.
  4480.  
  4481.      - undefine_key
  4482.           undefines a key.
  4483.  
  4484.      - end_macro
  4485.           ends the recording of a current macro.  Mostly useless, but it
  4486.           made for a useful menu entry.
  4487.  
  4488.      - key_set_impress
  4489.           THIS FUNCTION HAS BEEN DELETED AS OF VERSION 2.10.
  4490.  
  4491.  
  4492.  
  4493.  
  4494.                           Bingo 2.10e Reference Manual
  4495.                                        74
  4496.  
  4497.  
  4498.  
  4499.  
  4500.      Windows
  4501.      -------
  4502.  
  4503.      - window_edit
  4504.           this function ask for a filename, then splits the window and
  4505.           essentially performs and edit_file function for the requested
  4506.           filename.
  4507.  
  4508.      - window_load
  4509.           works like window_edit, except it forces a reload of the named
  4510.           file.
  4511.  
  4512.      - window_split
  4513.           this simply splits the current window in two and uses the current
  4514.           file for both.
  4515.  
  4516.      - window_vertical
  4517.           splits the current window vertically.  Windows can only be split
  4518.           so once.
  4519.  
  4520.      - window_close
  4521.           closes the current window and expands the above window to use its
  4522.           space.
  4523.  
  4524.      - window_zoom
  4525.           toggles the display between zoomed mode.  When the display is
  4526.           zoomed, the current window takes up the entire display, but Bingo
  4527.           'remembers' the rest of the windows and will restore them when
  4528.           zoom mode is toggled again.
  4529.  
  4530.      - window_one
  4531.           this function makes the current window the only window, wiping
  4532.           out all other windows.
  4533.  
  4534.      - window_next
  4535.           this moves to the next window down, or wraps to the top window if
  4536.           necessary.
  4537.  
  4538.      - window_previous
  4539.           this moves to the next window up, or wraps to the bottom if
  4540.           necessary.
  4541.  
  4542.      - window_top
  4543.           jumps to the topmost, leftmost window.
  4544.  
  4545.      - window_bottom
  4546.           jumps to the bottom-most, rightmost window.
  4547.  
  4548.  
  4549.  
  4550.  
  4551.  
  4552.                           Bingo 2.10e Reference Manual
  4553.                                        75
  4554.  
  4555.  
  4556.  
  4557.  
  4558.      - window_resize
  4559.           this allows you to resize the current window (and its left or
  4560.           right sibling, if it exists) and the window below (and *its* left
  4561.           or right sibling, if it exists) by 'rubberbanding' the current
  4562.           status line up and down.
  4563.  
  4564.  
  4565.  
  4566.  
  4567.  
  4568.  
  4569.  
  4570.  
  4571.  
  4572.  
  4573.  
  4574.  
  4575.  
  4576.  
  4577.  
  4578.  
  4579.  
  4580.  
  4581.  
  4582.  
  4583.  
  4584.  
  4585.  
  4586.  
  4587.  
  4588.  
  4589.  
  4590.  
  4591.  
  4592.  
  4593.  
  4594.  
  4595.  
  4596.  
  4597.  
  4598.  
  4599.  
  4600.  
  4601.  
  4602.  
  4603.  
  4604.  
  4605.  
  4606.  
  4607.  
  4608.  
  4609.  
  4610.                           Bingo 2.10e Reference Manual
  4611.                                        76
  4612.  
  4613.  
  4614.  
  4615.  
  4616.      Printing
  4617.      --------
  4618.  
  4619.      - print_file
  4620.           print the current file, or a marked block if there is one, using
  4621.           the current printer settings, to the current destination. 
  4622.           Whenever Bingo encounters a formfeed character, it will assume
  4623.           that is the start of a new page, and start the remainder of the
  4624.           line at the left margin.
  4625.  
  4626.      - send_lf
  4627.           send a line feed character to the destination.
  4628.  
  4629.      - send_ff
  4630.           send a formfeed character to the destination
  4631.  
  4632.      - send_sequence
  4633.           send a sequence of character values to the printer; e.g.
  4634.                          12,12,12,12,12
  4635.           sends a series of 5 ASCII 12's (decimal) to the destination
  4636.  
  4637.  
  4638.  
  4639.  
  4640.  
  4641.  
  4642.  
  4643.  
  4644.  
  4645.  
  4646.  
  4647.  
  4648.  
  4649.  
  4650.  
  4651.  
  4652.  
  4653.  
  4654.  
  4655.  
  4656.  
  4657.  
  4658.  
  4659.  
  4660.  
  4661.  
  4662.  
  4663.  
  4664.  
  4665.  
  4666.  
  4667.  
  4668.                           Bingo 2.10e Reference Manual
  4669.                                        77
  4670.  
  4671.  
  4672.  
  4673.  
  4674.      Error Parsing and Undo
  4675.      ----------------------
  4676.  
  4677.      - setup_err_parse
  4678.           this function will prompt you for a filename.  Bingo will from
  4679.           then on use the named file as the error file.  This must be
  4680.           called before next_error, prev_error, or last_error are called.
  4681.  
  4682.      - next_error
  4683.           moves, within the current window, to the next error as found in
  4684.           the current error file.  If no more errors can be found, Bingo
  4685.           will say so, and display the last non-blank line in the error
  4686.           file.  Otherwise, Bingo will edit the appropriate file into the
  4687.           current window, as well as highlighting the line in the error
  4688.           file being referenced.
  4689.  
  4690.      - prev_error
  4691.           same as error except it moves backward through the error file.
  4692.  
  4693.      - last_error
  4694.           redisplays the last error message, if there was one.
  4695.  
  4696.      - rotate_kill
  4697.           pops up the current kill stack and allows you to arbitrarily move
  4698.           a line of text to the top of the stack.
  4699.  
  4700.      - unkill
  4701.           inserts the top member of the stack at the current position.  If
  4702.           the top member of the stack was a full line, it is inserted above
  4703.           the current line.  Removes the top member from the stack.
  4704.  
  4705.      - paste_kill
  4706.           inserts the top member of the stack at the current position.  If
  4707.           the top member of the stack was a full line, it is inserted above
  4708.           the current line.  Leaves the stack itself alone.
  4709.  
  4710.      - restore_line
  4711.           restores the current line to its former form.
  4712.  
  4713.  
  4714.  
  4715.  
  4716.  
  4717.  
  4718.  
  4719.  
  4720.  
  4721.  
  4722.  
  4723.  
  4724.  
  4725.  
  4726.                           Bingo 2.10e Reference Manual
  4727.                                        78
  4728.  
  4729.  
  4730.  
  4731.  
  4732.      Configuration
  4733.      -------------
  4734.  
  4735.      - save_settings
  4736.           saves the current config settings to the image of BE.EXE on disk.
  4737.  
  4738.      - conf_color
  4739.           configure the color settings.  You select the color you are
  4740.           interested in by pressing the appropriate color.  Then, by
  4741.           watching the bottom line on the screen and pressing the up and
  4742.           down arrow keys for the foreground and the pageup and pagedown
  4743.           keys for the background, you select the color you want.  Pressing
  4744.           return will select the color.  For the overscan (border)
  4745.           attribute, only the background attribute matters.
  4746.  
  4747.      - conf_lfs
  4748.           alter the lfs-only setting.  If on, this setting has Bingo write
  4749.           files with lines separated by LF's only, in the UNIX fashion. 
  4750.           Otherwise, Bingo uses CR-LF pairs to delimit lines.
  4751.  
  4752.      - conf_backups
  4753.           allows you to specify the character Bingo uses to automatically
  4754.           create backup files when a file is saved.  The algorithm used
  4755.           takes the character you give and uses it to flesh out the
  4756.           extension of the original file to three characters; if the
  4757.           extension is already 3 characters long, the backup character
  4758.           replaces the third character of the extension.  For example, if
  4759.           the backup character is '$', 
  4760.                main.c         becomes        main.c$$
  4761.                main.cp        becomes        main.cp$
  4762.                main.pas       becomes        main.pa$
  4763.  
  4764.      - conf_eof
  4765.           alter whether Bingo writes a EOF character at the end of files
  4766.           (^Z).
  4767.  
  4768.      - conf_tabexpand
  4769.           THIS FUNCTION HAS BEEN DELETED AS OF VERSION 2.10.
  4770.  
  4771.      - conf_search
  4772.           allows you to predetermine which flags (I/G/B/etc...) will be set
  4773.           initially for a search and replace attempts.
  4774.  
  4775.      - conf_stripping
  4776.           onfigure whether Bingo strips the high bit of characters when
  4777.           reading.  Only really useful when reading Wordstar files.
  4778.  
  4779.      - conf_rmargin
  4780.           set the right margin.  Affects paragraph reformatting and word
  4781.           wrap.  This changes the current buffer's setting and the global
  4782.           setting.
  4783.  
  4784.                           Bingo 2.10e Reference Manual
  4785.                                        79
  4786.  
  4787.  
  4788.  
  4789.  
  4790.      - conf_autoindent
  4791.           set whether Bingo uses autoindent mode.  Affects paragraph
  4792.           reformatting and word wrap.  This changes both the current
  4793.           buffer's setting and the global setting.
  4794.  
  4795.      - conf_wordwrap
  4796.           set the word wrap mode.  This changes both the current buffer's
  4797.           setting and the global setting.
  4798.  
  4799.      - conf_insert
  4800.           whether Bingo is in insert/overwrite mode.  This changes both the
  4801.           current buffer's setting and the global setting.
  4802.  
  4803.      - conf_tabsize
  4804.           set the tabsize.  This changes both the current buffer's setting
  4805.           and the global setting.
  4806.  
  4807.      - conf_backspace
  4808.           configure the backspace mode
  4809.                          1. Delete single chars
  4810.                          2. Delete spaces back to tab setting
  4811.                          3. Delete spaces to left margin
  4812.           This changes both the current buffer's setting and the global
  4813.           setting.
  4814.  
  4815.      - conf_macro_death
  4816.           set whether a keystroke interrupts macros.  If on, this will slow
  4817.           things down a bit, but can prevent runaway macros.
  4818.  
  4819.      - conf_cmode
  4820.           configure whether Bingo uses C Mode on *.c and *.h files.  Allows
  4821.           you to choose between two different modes of C indention:
  4822.  
  4823.                     for(i=0;i<10;i++){   and    for(i=0;i<10;i++)
  4824.                          ...stuff...            {
  4825.                     }                                ...stuff...
  4826.                                                 }
  4827.           This changes both the current buffer's setting and the global
  4828.           setting.
  4829.  
  4830.      - conf_sound
  4831.           allows you to set the frequency of the beep Bingo uses.  Setting
  4832.           it to zero will effectively turn off the sound.
  4833.  
  4834.  
  4835.  
  4836.  
  4837.  
  4838.  
  4839.  
  4840.  
  4841.  
  4842.                           Bingo 2.10e Reference Manual
  4843.                                        80
  4844.  
  4845.  
  4846.  
  4847.  
  4848.      - conf_mdelay
  4849.           allows you to specify the timing delay between repetitions of a
  4850.           function(s) being executed while a mouse button is held down. 
  4851.           For example, on reasonably quick machines, paging down while
  4852.           holding the mouse button down on one of the status line
  4853.           "hotspots" occurred so fast with version 2.0 so as to be useless. 
  4854.  
  4855.  
  4856.      - conf_button_wait
  4857.           allows you to configure, in milliseconds, the amount of delay
  4858.           Bingo will wait for the second click of a double click.
  4859.      - conf_shadow
  4860.           silly function, configures whether Bingo uses "shadow" boxes. 
  4861.           Play with it, amaze your friends.
  4862.  
  4863.      - conf_win_close
  4864.           controls whether Bingo automatically closes a window when the
  4865.           file is closed.
  4866.  
  4867.      - conf_def_ext
  4868.           allows you to specify the file extensions Bingo will attempt to
  4869.           use when you specify a filename without '.'.  The extensions are
  4870.           checked in order.
  4871.  
  4872.      - conf_video_mode
  4873.           allows you to choose from between three screen handling options:
  4874.                     - autodetect with retrace checking
  4875.                     - autodetect with no retrace checking
  4876.                     - 43 or 50 line mode, if supported
  4877.           Retrace checking will only be in effect if there are only 25
  4878.           lines to be displayed.
  4879.  
  4880.      - conf_cursor
  4881.           THIS FUNCTION HAS BEEN DROPPED FROM VERSION 2.10.
  4882.  
  4883.      - conf_prn
  4884.           set the printer destination, between the default serial port, the
  4885.           default parallel port, or a file.
  4886.  
  4887.      - conf_tmarg
  4888.           set the top margin, in terms of number of lines.
  4889.  
  4890.      - conf_bmarg
  4891.           set the bottom margin, in terms of number of lines.
  4892.  
  4893.      - conf_lmarg
  4894.           set the left margin which will be used when printing, in terms of
  4895.           spaces.
  4896.  
  4897.      - conf_lines_per
  4898.           set the lines per page, counting the top margin.
  4899.  
  4900.                           Bingo 2.10e Reference Manual
  4901.                                        81
  4902.  
  4903.  
  4904.  
  4905.  
  4906.  
  4907.      - conf_null
  4908.           THIS FUNCTION HAS BEEN DROPPED FROM VERSION 2.10.
  4909.  
  4910.      - conf_ctrl_display
  4911.           THIS FUNCTION HAS BEEN DROPPED FROM VERSION 2.10.
  4912.  
  4913.      - conf_kill_size
  4914.           alters the size of the kill buffer.
  4915.  
  4916.      - conf_cut_stack
  4917.           allows you to choose whether text about to be discarded from the
  4918.           paste buffer should be placed on the stack.  If this is on, this
  4919.           will slow block operations down a bit, but it is a nice safety
  4920.           feature.
  4921.  
  4922.      - conf_auto_cut
  4923.           allows you to toggle how the 'cut' & 'copy' functions respond
  4924.           when no block has been marked.  If auto cut is active, these
  4925.           functions will cut (or copy) the current line.  If auto cut is
  4926.           not active, the current line will be Linemarked.
  4927.  
  4928.      - conf_smart_tabs
  4929.           allows you to specify whether or not "Smart" tabs are active. 
  4930.           Smart tabs cause the 'insert_tab' function to tab over to the
  4931.           same column as the next nonspace character on the line previous. 
  4932.           This changes both the current buffer's setting and the global
  4933.           setting.
  4934.  
  4935.      - conf_matching
  4936.           configures matching mode.  If matching mode is active, entering a
  4937.           '[{<(' character will cause its matching close member to be
  4938.           entered automatically.  This changes both the current buffer's
  4939.           setting and the global setting.
  4940.  
  4941.      - conf_trail
  4942.           allows you to configure whether or not Bingo strips trailing
  4943.           spaces.
  4944.  
  4945.  
  4946.  
  4947.  
  4948.  
  4949.  
  4950.  
  4951.  
  4952.  
  4953.  
  4954.  
  4955.  
  4956.  
  4957.  
  4958.                           Bingo 2.10e Reference Manual
  4959.                                        82
  4960.  
  4961.  
  4962.  
  4963.  
  4964.      - conf_bounce
  4965.           allows you what cursor movement paradigm Bingo uses.  If Bounce
  4966.           mode is active, Bingo views the entire document as one long
  4967.           string of characters.  Thus, you cannot move off of exiting text. 
  4968.           Further, the cursor will automatically wrap at the end of lines. 
  4969.           If Bounce mode is turned off, cursor movement is by the more
  4970.           traditional method, where you can move any where (horizontally)
  4971.           you wish.
  4972.  
  4973.      - conf_key_bios
  4974.           this governs whether or not Bingo will use the Extended Keyboard
  4975.           Bios if it is found.  On some machines, Bingo may identify it
  4976.           incorrectly, or there may be compatibility problems.  This
  4977.           function allows you to tell Bingo to disregard the extended Bios,
  4978.           even if it is found.  If this is on, the two sets of arrow keys,
  4979.           for example, will be recognized as different.  They will
  4980.           therefore have to be defined separately in your keyboard config
  4981.           file.
  4982.  
  4983.      - conf_erronly
  4984.           allows you to tell Bingo to further restrict valid error lines to
  4985.           those containing the word 'error' (any case).  
  4986.  
  4987.      - conf_mouse
  4988.           controls whether or not Bingo uses a Mouse, if it finds one.
  4989.  
  4990.      - conf_profile
  4991.           controls whether Bingo will check for, and load if found, the
  4992.           profile file of a file's file extension each time a file is
  4993.           loaded.
  4994.  
  4995.      - conf_word
  4996.           allows you to edit the string containing what characters are not
  4997.           part of a word.
  4998.  
  4999.      - conf_scr_save
  5000.           controls whether Bingo will save, and then restore, the DOS
  5001.           screen upon startup and exit.  Will cost you some memory.
  5002.  
  5003.      - conf_name_save
  5004.           controls whether, and how, Bingo saves the last 15 files edited. 
  5005.           You can turn it off, tell it to save the info in the current
  5006.           directory (where Bingo looks first upon startup), or in Bingo's
  5007.           home directory.
  5008.  
  5009.      - conf_delims
  5010.           allows you to input and edit pairs of delimiters for Bingo to
  5011.           balance with the 'match_delim' function.  Both delimiters must be
  5012.           non-blank.
  5013.  
  5014.  
  5015.  
  5016.                           Bingo 2.10e Reference Manual
  5017.                                        83
  5018.  
  5019.  
  5020.  
  5021.  
  5022.      - conf_eol_display
  5023.           allows you to enter the ASCII decimal value of the character to
  5024.           be displayed as the end of line character.  The default is 32,
  5025.           the space character.
  5026.  
  5027.      - conf_exit_to_pick
  5028.           controls Bingo's actions upon exit.  If turned on, Bingo will
  5029.           popup an edit box when you quit the program (except when you exit
  5030.           through the abort_all function).
  5031.  
  5032.      - conf_prn_eol
  5033.           controls whether Bingo terminates lines with a linefeed only or a
  5034.           carraige return/linefeed pair while printing.
  5035.  
  5036.      - conf_prn_lineno
  5037.           sets whether or not Bingo prints line numbers on each line it
  5038.           prints.
  5039.  
  5040.      - conf_prn_header
  5041.           sets whether or not Bingo prints page headers on each page it
  5042.           prints.  Headers consist of the filename, the page number, and
  5043.           the date/time.
  5044.  
  5045.      - conf_timed_backups
  5046.           allows you to specify how often, in terms of changes, to save a
  5047.           backup of a file.  A value of zero (0) indicates no automatic
  5048.           backups are to take place.  The value input becomes the defult
  5049.           value for any subsequently entered files, and becomes the value
  5050.           for the current file; it does not change the value for any
  5051.           existing files.  Any operation which changes the file will
  5052.           increment the change counter.  The current number of changes for
  5053.           each file is displayed on the info screen.  When the
  5054.           predetermined number of changes has occurred, the file is saved
  5055.           as 
  5056.                  backXXXX.bak 
  5057.           where XXXX is the buffer 4 digit id number.  This id number is
  5058.           unique over an editing session, and is displayed as part of the
  5059.           info screen.  The backup files are identical to the files
  5060.           themselves, except that the first line contains the original name
  5061.           of the file (full pathname) and the time of the backup. 
  5062.  
  5063.           *Note*: Be very careful with setting this value.  Generally, a
  5064.           setting between 256 and 1024 is very useful.  However, if you are
  5065.           editing a multi-megabyte file, backups can be a large pain
  5066.           because of the time involved in saving the file.  
  5067.  
  5068.  
  5069.  
  5070.  
  5071.  
  5072.  
  5073.  
  5074.                           Bingo 2.10e Reference Manual
  5075.                                        84
  5076.  
  5077.  
  5078.  
  5079.  
  5080.                                 License Agreement
  5081.                                 -----------------
  5082.  
  5083.           This section tells you is how to become a registered user once
  5084.      you decide that you like the program and want to use it on a regular
  5085.      basis.
  5086.  
  5087.           Bingo is distributed under the shareware marketing concept; it is
  5088.      not free software and it has not been released to the public domain.
  5089.      The documentation, executable images, and all other files distributed
  5090.      with Bingo are copyrighted.
  5091.  
  5092.           Shareware is a way of distributing computer software that allows
  5093.      you to try out a program before you purchase it. Programs distributed
  5094.      as shareware typically give you some period of time to use the program
  5095.      and evaluate its usefulness to you. If the program doesn't meet your
  5096.      needs, you're under no obligation to pay for it. If you do find the
  5097.      program useful and wish to continue using it on a regular basis, the
  5098.      shareware program's author usually requests that you pay for the
  5099.      program by sending him or her a completed registration form and
  5100.      payment. This is the approach I have taken in making Bingo available
  5101.      to the public.
  5102.  
  5103.           If you find Bingo to be a useful addition to your software
  5104.      library, you're requested to become a registered user by completing
  5105.      the enclosed registration form and returning it along with the
  5106.      indicated license/registration fee. I hope that you will agree that
  5107.      the $40.00 license fee (for the Single Version registration) or $75.00
  5108.      license fee (for the Lifetime registration) is a small price to pay
  5109.      for the continued use of the program. It requires a large investment
  5110.      to develop, market, and support a product of this complexity. Your
  5111.      support in the form of a license/registration fee will continue to
  5112.      make good software available at low prices.
  5113.  
  5114.           Quantity discounts are available to business, government, and
  5115.      other organizations that wish to use Bingo on multiple computer
  5116.      systems. Bingo is also available at very special rates to
  5117.      organizations who wish to use it for promotional purposes. Write the
  5118.      author for information on using the program this way.
  5119.  
  5120.           You are granted a limited license to use and examine Bingo on a
  5121.      trial basis to determine if Bingo is suitable for your needs. If you
  5122.      find Bingo useful and continue to use it on a regular basis, you
  5123.      should complete and return the registration form along with the
  5124.      indicated license/registration fee.
  5125.  
  5126.  
  5127.  
  5128.  
  5129.  
  5130.  
  5131.  
  5132.                           Bingo 2.10e Reference Manual
  5133.                                        85
  5134.  
  5135.  
  5136.  
  5137.  
  5138.           You are encouraged to make copies of Bingo for the trial use of
  5139.      other individuals and organizations, subject to the following
  5140.      restrictions:
  5141.           1)   All Bingo distribution files must be copied in unmodified
  5142.                form.
  5143.           2)   You may not include any other files with the distributed
  5144.                copy.
  5145.  
  5146.           You may not distribute Bingo with any other product or
  5147.      service without written permission of the author.
  5148.  
  5149.           Bingo may be included on electronic bulletin board systems for
  5150.      downloading by users of the bulletin board provided the above
  5151.      restrictions are met.
  5152.  
  5153.           Bingo and all accompanying materials are provided "as is" without
  5154.      warranty of any kind. The entire risk of using Bingo is assumed by
  5155.      you.
  5156.  
  5157.           The author, Christopher R. S. Schanck, makes no warranty of any
  5158.      kind, expressed or implied, including but not limited to any
  5159.      warranties of merchantability and fitness for a particular purpose.
  5160.  
  5161.           In no event will the author, Christopher R. S. Schanck, be liable
  5162.      for any damages whatsoever arising out of your use or inability to use
  5163.      the program.
  5164.  
  5165.           If you use Bingo on a regular basis, you should complete the
  5166.      registration form at the end of this document and return it along with
  5167.      the indicated license/registration fee. Registration gives you the
  5168.      right to use the software as documented in the license.
  5169.  
  5170.           A registration fee of $40.00 establishes you as a registered user
  5171.      of the current version of Bingo. 
  5172.  
  5173.           A registration of $75.00 establishes you as a Lifetime
  5174.      registrant, and in this situation you are entitled to the next version
  5175.      of Bingo free.  After that, you will be notified of each subsequent
  5176.      version, and they will be available for a five (5) dollar fee.
  5177.  
  5178.           When you submit your registration fee, unless you specifically
  5179.      request otherwise, the author will mail you a copy of the current
  5180.      version of Bingo and accompanying documentation on disk (3.5" or
  5181.      5.25") for free.  Mailing addresses outside of the continental United
  5182.      States will need to submit a $15.00 shipping and handling charge.
  5183.  
  5184.  
  5185.  
  5186.  
  5187.  
  5188.  
  5189.  
  5190.                           Bingo 2.10e Reference Manual
  5191.                                        86
  5192.  
  5193.  
  5194.  
  5195.  
  5196.                          Registration Form - Bingo 2.10e
  5197.                          -------------------------------
  5198.  
  5199.      Remit to:            Christopher R.S. Schanck
  5200.                                    PO Box 279
  5201.                                 Hanover MD 21076
  5202.  
  5203.                                    Bingo 2.10e
  5204.  
  5205.      Disk size, circle one: (   3.5"   /   5.25"   / SEND NO DISK )
  5206.  
  5207.  
  5208.      Registration OPTIONS:
  5209.  
  5210.      One-Time Registration ............ _____ @ $ 40.00 each  $ _____
  5211.  
  5212.      Lifetime Registration ............ _____ @ $ 75.00 each  $ _____
  5213.  
  5214.  
  5215.  
  5216.      Bingo printed Documentation ...... _____ @ $ 15.00 each  $ _____
  5217.  
  5218.  
  5219.  
  5220.                                                     Subtotal  $ _____
  5221.  
  5222.  
  5223.      Shipping, Outside the Continental U.S. ......... $ 15.00 $ _____
  5224.  
  5225.                                             Total (U.S.Funds) $ _____
  5226.          
  5227.  
  5228.  
  5229.      Name: __________________________________________________________
  5230.  
  5231.      Company: _______________________________________________________
  5232.  
  5233.      Address: _______________________________________________________
  5234.  
  5235.      ________________________________________________________________
  5236.  
  5237.      ________________________________________________________________
  5238.  
  5239.      Day Phone: _______________________________ 
  5240.  
  5241.      Eve Phone: _______________________________
  5242.  
  5243.  
  5244.                     Prices subject to change without notice.
  5245.  
  5246.  
  5247.  
  5248.                           Bingo 2.10e Reference Manual
  5249.                                        87
  5250.  
  5251.  
  5252.  
  5253.  
  5254.                           Registration Form - Continued
  5255.  
  5256.      I acquired Bingo 2.10e from
  5257.  
  5258.      [ ] - Friend                
  5259.  
  5260.      [ ] - Computer Club
  5261.      Which One? ______________________________________________________
  5262.  
  5263.      [ ] - Electronic BBS        
  5264.      Which One? ______________________________________________________
  5265.      Phone #? ________________________________________________________
  5266.  
  5267.      [ ] - Other
  5268.      Specify: ________________________________________________________
  5269.  
  5270.      I would also appreciate any input you would care to give concerning
  5271.      Bingo. If you have any ideas or comments that would make Bingo a
  5272.      better program, then please let me know.
  5273.  
  5274.  
  5275.  
  5276.  
  5277.  
  5278.  
  5279.  
  5280.  
  5281.  
  5282.  
  5283.  
  5284.  
  5285.  
  5286.  
  5287.  
  5288.  
  5289.  
  5290.  
  5291.  
  5292.  
  5293.  
  5294.  
  5295.  
  5296.  
  5297.  
  5298.  
  5299.  
  5300.  
  5301.  
  5302.  
  5303.  
  5304.  
  5305.  
  5306.                           Bingo 2.10e Reference Manual
  5307.                                        88
  5308.  
  5309.  
  5310.  
  5311.  
  5312.                                    The Author
  5313.                                    ----------
  5314.  
  5315.           I received my M.S. in Computer Science from The Ohio State
  5316.      University in March of 1990, and am now employed by a large
  5317.      engineering/manufacturing firm in the Baltimore area.  I was born in a
  5318.      steel town in Eastern Pennsylvania, and attended The Pennsylvania
  5319.      State University as an undergraduate, graduating in May of 1988. I
  5320.      hold a first-degree Black Belt in Tae Kwon Do, and I am an avid reader
  5321.      of science-fiction, fantasy, military fiction, mythology, and just
  5322.      about any other occurance of the printed word.
  5323.  
  5324.  
  5325.  
  5326.  
  5327.  
  5328.  
  5329.  
  5330.  
  5331.  
  5332.  
  5333.  
  5334.  
  5335.  
  5336.  
  5337.  
  5338.  
  5339.  
  5340.  
  5341.  
  5342.  
  5343.  
  5344.  
  5345.  
  5346.  
  5347.  
  5348.  
  5349.  
  5350.  
  5351.  
  5352.  
  5353.  
  5354.  
  5355.  
  5356.  
  5357.  
  5358.  
  5359.  
  5360.  
  5361.  
  5362.  
  5363.  
  5364.                           Bingo 2.10e Reference Manual
  5365.                                        89
  5366.  
  5367.  
  5368.  
  5369.  
  5370.                                 Acknowledgements
  5371.                                 ----------------
  5372.  
  5373.           There are many I must acknowledge for the inspiration for writing
  5374.      this program: family, friends, colleagues. In addition, I want to
  5375.      thank Borland for their excellent Turbo C compiler, which I used to
  5376.      write Bingo; IBM for making my beloved baby, lo those many years ago;
  5377.      and all the other folks who wrote software I used to create Bingo. 
  5378.      Thanks to all my computer science professors, who instilled the
  5379.      knowledge to write such an application in me, often against my will. 
  5380.      I also thank the members of the Columbus Computer Society (CCS),
  5381.      particularly the members of the Programmer's SIG, several of whom
  5382.      served as Beta test people during versions 1.0 to 2.0, putting their
  5383.      programs In Harm's Way as they tested features.
  5384.           Thanks to the folks at Home Box Office for running an endless
  5385.      amount of truly bad movies at all hours of the night to keep me
  5386.      company on some of the more involved programming adventures.  
  5387.           And mucho thanks to my premier beta-tester, Bob Boyken, who was
  5388.      also the first registrant of version 1.1a.  Bob provided me with much
  5389.      needed time, effort, and ideas, not to mention a help file.  His
  5390.      efforts, both in using Bingo regularly, and in testing things for me
  5391.      on particular hardware combinations, was nothing short of awesome.
  5392.           Additional thanks to Rich Thompson, for looking at the earliest
  5393.      virtual-memory version of 2.10 and not cringing.  Or at least not
  5394.      cringing too much.
  5395.           Thanks to Beaker, Ernie, Cookie, and the rest of the Muppets for
  5396.      frequent sanity checks.
  5397.  
  5398.  
  5399.  
  5400.  
  5401.  
  5402.  
  5403.  
  5404.  
  5405.  
  5406.  
  5407.  
  5408.  
  5409.  
  5410.  
  5411.  
  5412.  
  5413.  
  5414.  
  5415.  
  5416.  
  5417.  
  5418.  
  5419.  
  5420.  
  5421.  
  5422.                           Bingo 2.10e Reference Manual
  5423.                                        90
  5424.  
  5425.  
  5426.  
  5427.  
  5428.                                       Index
  5429.                                       -----
  5430.  
  5431.      abort . . . . . . . . . . . . . . . . . . . 17, 18, 36, 46, 60, 61, 84
  5432.      abort_all . . . . . . . . . . . . . . . . . . . . . . . . . 36, 61, 84
  5433.      again . . . . . . . . . . .  6, 16, 22, 28, 34, 42, 47, 48, 51, 62, 75
  5434.      align . . . . . . . . . . . . . . . . . . . . . . . . . . .  2, 44, 70
  5435.      ascii_table . . . . . . . . . . . . . . . . . . . . . . . . 32, 46, 71
  5436.      author  . . . . . . . . . . . . . . . . . . . . . . . . 50, 85, 86, 89
  5437.      back_space  . . . . . . . . . . . . . . . . . . . . . . . . . . 58, 59
  5438.      back_tab  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
  5439.      backup_all  . . . . . . . . . . . . . . . . . . . . . . . . . . 37, 61
  5440.      backup_file . . . . . . . . . . . . . . . . . . . . . . . . . . 37, 61
  5441.      begin_line  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
  5442.      begin_of_text   . . . . . . . . . . . . . . . . . . . . . . . . . . 65
  5443.      block_copy  . . . . . . . . . . . . . . . . . . . . . . . . . . 43, 67
  5444.      block_delete  . . . . . . . . . . . . . . . . . . . . . . . . . 43, 68
  5445.      block_load  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
  5446.      block_move  . . . . . . . . . . . . . . . . . . . . . . . . . . 43, 67
  5447.      block_save  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
  5448.      bot_of_file . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
  5449.      bottom_of_block . . . . . . . . . . . . . . . . . . . . . . . . . . 65
  5450.      bottom_of_screen  . . . . . . . . . . . . . . . . . . . . . . . . . 64
  5451.      buffer_info . . . . . . . . . . . . . . . . . . . . . . . . . . 43, 68
  5452.      carriage  . . . . . . . . . . . . . . . . . . . . . . . . . . . 35, 58
  5453.      center_line . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
  5454.      center_text   . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
  5455.      chdir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48, 73
  5456.      choose_file . . . . . . . . . . . . . . . . . . . . . . . . . . 35, 60
  5457.      clean_all   . . . . . . . . . . . . . . . . . . . . . . . . . . 36, 61
  5458.      clean_file  . . . . . . . . . . . . . . . . . . . . . . . . . . 36, 61
  5459.      cmd_line  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
  5460.      compuserve  . . . . . . . . . . . . . . . . . . . . . . . . .  5, 8, 9
  5461.      conf_auto_cut . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
  5462.      conf_autoindent . . . . . . . . . . . . . . . . . . . . . . . . . . 80
  5463.      conf_backspace  . . . . . . . . . . . . . . . . . . . . . . . . . . 80
  5464.      conf_backups  . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
  5465.      conf_bmarg  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
  5466.      conf_bounce . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
  5467.      conf_button_wait  . . . . . . . . . . . . . . . . . . . . . . . . . 81
  5468.      conf_cmode  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
  5469.      conf_color  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
  5470.      conf_ctrl_display . . . . . . . . . . . . . . . . . . . . . . . . . 82
  5471.      conf_cursor . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
  5472.      conf_cut_stack  . . . . . . . . . . . . . . . . . . . . . . . . 55, 82
  5473.      conf_def_ext  . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
  5474.      conf_delims   . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
  5475.      conf_eof  . . . . . . . . . . . . . . . . . . . . . . . . . . . 35, 79
  5476.      conf_eol_display  . . . . . . . . . . . . . . . . . . . . . . . . . 84
  5477.      conf_erronly  . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
  5478.      conf_exit_to_pick   . . . . . . . . . . . . . . . . . . . . . . . . 84
  5479.  
  5480.                           Bingo 2.10e Reference Manual
  5481.                                        91
  5482.  
  5483.  
  5484.  
  5485.  
  5486.      conf_insert . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
  5487.      conf_key_bios . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
  5488.      conf_kill_size  . . . . . . . . . . . . . . . . . . . . . . . . 55, 82
  5489.      conf_lfs  . . . . . . . . . . . . . . . . . . . . . . . . . . . 35, 79
  5490.      conf_lines_per  . . . . . . . . . . . . . . . . . . . . . . . . . . 81
  5491.      conf_lmarg  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
  5492.      conf_macro_death  . . . . . . . . . . . . . . . . . . . . . . . . . 80
  5493.      conf_matching . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
  5494.      conf_mdelay . . . . . . . . . . . . . . . . . . . . . . . . . . 30, 81
  5495.      conf_mouse  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
  5496.      conf_name_save  . . . . . . . . . . . . . . . . . . . . . . . . . . 83
  5497.      conf_null . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
  5498.      conf_prn  . . . . . . . . . . . . . . . . . . . . . . . . . . . 81, 84
  5499.      conf_prn_eol  . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
  5500.      conf_prn_header   . . . . . . . . . . . . . . . . . . . . . . . . . 84
  5501.      conf_prn_lineno   . . . . . . . . . . . . . . . . . . . . . . . . . 84
  5502.      conf_profile  . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
  5503.      conf_rmargin  . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
  5504.      conf_scr_save   . . . . . . . . . . . . . . . . . . . . . . . . . . 83
  5505.      conf_search . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
  5506.      conf_shadow . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
  5507.      conf_smart_tabs . . . . . . . . . . . . . . . . . . . . . . . . . . 82
  5508.      conf_sound  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
  5509.      conf_stripping  . . . . . . . . . . . . . . . . . . . . . . . . . . 79
  5510.      conf_tabexpand  . . . . . . . . . . . . . . . . . . . . . . . . . . 79
  5511.      conf_tabsize  . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
  5512.      conf_timed_backups  . . . . . . . . . . . . . . . . . . . . . . 37, 84
  5513.      conf_tmarg  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
  5514.      conf_trail  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
  5515.      conf_video_mode . . . . . . . . . . . . . . . . . . . . . . . . . . 81
  5516.      conf_word   . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
  5517.      conf_wordwrap . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
  5518.      copy  . . . . . . . . 4, 9, 11, 36, 42, 43, 55, 61, 67, 68, 72, 82, 86
  5519.      copy_append . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
  5520.      cur_file  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
  5521.      cursor_down . . . . . . . . . . . . . . . . . . . . . . . . . . 30, 64
  5522.      cursor_left . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
  5523.      cursor_right  . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
  5524.      cursor_up . . . . . . . . . . . . . . . . . . . . . . . . . . . 47, 64
  5525.      cut . . . . . . . . . . . . . . . . . . . . 42, 43, 55, 59, 67, 68, 82
  5526.      cut_append  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
  5527.      default_bspace  . . . . . . . . . . . . . . . . . . . . . . . . . . 59
  5528.      default_del . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
  5529.      define_scrap  . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
  5530.      del_bol . . . . . . . . . . . . . . . . . . . . . . . . . . 34, 55, 59
  5531.      del_char  . . . . . . . . . . . . . . . . . . . . . . . . . . . 58, 59
  5532.      del_eol . . . . . . . . . . . . . . . . . . . . . . . . . . 34, 55, 59
  5533.      del_line  . . . . . . . . . . . . . . . . . . . . . . . . . 34, 55, 59
  5534.      del_word_lt   . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
  5535.      del_word_rt   . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
  5536.      delete_file . . . . . . . . . . . . . . . . . . . . . . . . . . 36, 61
  5537.  
  5538.                           Bingo 2.10e Reference Manual
  5539.                                        92
  5540.  
  5541.  
  5542.  
  5543.  
  5544.      detab . . . . . . . . . . . . . . . . . . . . . . . . . . .  1, 44, 69
  5545.      display_file  . . . . . . . . . . . . . . . . . . . . . . . . . 47, 72
  5546.      down_page . . . . . . . . . . . . . . . . . . . . . . . . . . . 30, 64
  5547.      dup_line  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
  5548.      edit_file . . . . . . . . . . . . . . . . . . . 35, 36, 52, 54, 60, 75
  5549.      emacs_yank  . . . . . . . . . . . . . . . . . . . . . . . . . . 43, 68
  5550.      end_line  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
  5551.      end_macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
  5552.      entab . . . . . . . . . . . . . . . . . . . . . . . . . . .  1, 44, 69
  5553.      exec_command  . . . . . . . . . . . . . . . . . . . . . . . . . 48, 73
  5554.      extend_mark . . . . . . . . . . . . . . . . . . . . . . . . . . 42, 67
  5555.      fcase_block . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
  5556.      file  . .  1-3, 6, 10-14, 17, 19-22, 24-27, 29, 30, 33, 35-38, 41, 42,
  5557.                  44-47, 51-55, 58, 60-65, 67-69, 71, 72, 74, 75, 77-79, 81,
  5558.                                                                  83, 84, 90
  5559.      file_all  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
  5560.      fill_block  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
  5561.      global  . . . . . . . . . . . . . . . . . . . . 46, 63, 71, 79, 80, 82
  5562.      help  . . . . . . . 1, 2, 7, 11, 18, 29, 31, 39, 45, 47, 56, 70-72, 90
  5563.      indent_down . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
  5564.      indent_up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
  5565.      info  . . . . . . . . . . .  4, 18, 31, 43, 45, 48, 68, 71, 72, 83, 84
  5566.      insert_tab  . . . . . . . . . . . . . . . . . . . . . . . . . . 58, 82
  5567.      jump  . . . . . . . . . . . . . . . . . . . . . . . . . 41, 54, 64, 65
  5568.      jump_mark . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
  5569.      key_set_impress . . . . . . . . . . . . . . . . . . . . . . . . . . 74
  5570.      key_set_load  . . . . . . . . . . . . . . . . . . . . . . . . . 22, 74
  5571.      key_set_save  . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
  5572.      last_error  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
  5573.      lcase_block . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
  5574.      leap_backward   . . . . . . . . . . . . . . . . . . . . . . . . . . 63
  5575.      leap_forward  . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
  5576.      license . . . . . . . . . . . . . . . . . . . . . . . . . .  4, 85, 86
  5577.      line_mark . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
  5578.      load_file . . . . . . . . . . . . . . . . . . . . . 25, 26, 35, 52, 60
  5579.      load_profile  . . . . . . . . . . . . . . . . . . . . . . . . . 46, 71
  5580.      look_buffer . . . . . . . . . . . . . . . . . . . . . . . . . . 43, 68
  5581.      macro  1, 2, 6, 12, 21, 24-26, 29, 38, 39, 46, 50, 51, 54, 63, 70, 71,
  5582.                                                                      74, 80
  5583.      main_menu . . . . . . . . . . . . . . . . . . . . . . . . . . . 16, 58
  5584.      mark_last_found   . . . . . . . . . . . . . . . . . . . . . . . . . 63
  5585.      match_delim . . . . . . . . . . . . . . . . . . . . . . . . . . 70, 83
  5586.      modify_save . . . . . . . . . . . . . . . . . . . . . . 25, 36, 60, 61
  5587.      modify_save_all . . . . . . . . . . . . . . . . . . . . . . 25, 36, 61
  5588.      mouse_scroll  . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
  5589.      name_buffer . . . . . . . . . . . . . . . . . . . . . . . . . . 43, 68
  5590.      next_error  . . . . . . . . . . . . . . . . . . . . . . . . 25, 54, 78
  5591.      next_file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
  5592.      next_word . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
  5593.      onekey_def  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
  5594.      open_end  . . . . . . . . . . . . . . . . . . . . . . . . . . . 25, 26
  5595.  
  5596.                           Bingo 2.10e Reference Manual
  5597.                                        93
  5598.  
  5599.  
  5600.  
  5601.  
  5602.      paste . . . . . . . . . . . . . 17, 42, 43, 48, 55, 56, 67, 68, 78, 82
  5603.      paste_kill  . . . . . . . . . . . . . . . . . . . . . . 43, 56, 68, 78
  5604.      paste_replace . . . . . . . . . . . . . . . . . . . . . . . . . 42, 67
  5605.      pick_exec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
  5606.      pick_file   . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
  5607.      place_mark  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
  5608.      point_mark  . . . . . . . . . . . . . . . . . . . . . . . . . . 29, 67
  5609.      prev_error  . . . . . . . . . . . . . . . . . . . . . . . . . . 54, 78
  5610.      prev_file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
  5611.      prev_word . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
  5612.      print_file  . . . . . . . . . . . . . . . . . . . . . . . . . . 53, 77
  5613.      query_quote . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
  5614.      quit  . . . . . . . . . . . . . . . . . 17, 35, 36, 45, 60, 63, 71, 84
  5615.      quit_all  . . . . . . . . . . . . . . . . . . . . . . . . . . . 36, 60
  5616.      quit_and_save_status  . . . . . . . . . . . . . . . . . . . . . . . 71
  5617.      reform_para . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
  5618.      register  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  4
  5619.      rename_file . . . . . . . . . . . . . . . . . . . . . . . . . . 35, 60
  5620.      repeat  . . . . . . . . . . . . . . . . . . . 1, 2, 47, 50, 62, 70, 72
  5621.      repeat_last   . . . . . . . . . . . . . . . . . . . . . . . . . 47, 72
  5622.      replace . . . . . . . . . . .  1, 2, 24, 38-40, 42, 46, 62, 63, 67, 79
  5623.      report_bsize  . . . . . . . . . . . . . . . . . . . . . . . . . 43, 68
  5624.      restore_line  . . . . . . . . . . . . . . . . . . . . . . . . . 55, 78
  5625.      rotate_kill . . . . . . . . . . . . . . . . . . . . . . . . . . 56, 78
  5626.      run_macro_file  . . . . . . . . . . . . . . . . . . . . . . . . . . 74
  5627.      save_all  . . . . . . . . . . . . . . . . . . . . . . . . . 25, 36, 61
  5628.      save_file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
  5629.      save_settings . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
  5630.      scrap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50, 74
  5631.      scroll_down . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
  5632.      scroll_left   . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
  5633.      scroll_right  . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
  5634.      scroll_up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
  5635.      search  . . . . . . . . 1, 2, 19, 24-26, 38-40, 46, 50, 62, 63, 70, 79
  5636.      search_macro  . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
  5637.      send_ff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
  5638.      send_lf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
  5639.      send_sequence . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
  5640.      setup_err_parse . . . . . . . . . . . . . . . . . . . . . . 25, 54, 78
  5641.      shell . . . . . . . . . . . . . . . . . . . . . . . . . . . 33, 48, 73
  5642.      shift_block . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
  5643.      show_marks  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
  5644.      single_key_load . . . . . . . . . . . . . . . . . . . . . . . . . . 74
  5645.      single_key_save . . . . . . . . . . . . . . . . . . . . . . . . . . 74
  5646.      snap_to_mouse_xy  . . . . . . . . . . . . . . . . . . . . . . . 29, 65
  5647.      sort_block  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
  5648.      strip_highbit . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
  5649.      support . . . . . . . . . . . . . . 1, 2, 4, 7, 15, 31, 33, 38, 50, 85
  5650.      swap_buf_and_block  . . . . . . . . . . . . . . . . . . . . . . . . 68
  5651.      swap_execute  . . . . . . . . . . . . . . . . . . . . . 25, 47, 48, 73
  5652.      swap_shell  . . . . . . . . . . . . . . . . . . . . . . . . . . 48, 73
  5653.  
  5654.                           Bingo 2.10e Reference Manual
  5655.                                        94
  5656.  
  5657.  
  5658.  
  5659.  
  5660.      switch_file . . . . . . . . . . . . . . . . . . . . . . . . . . 36, 60
  5661.      time_stamp  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
  5662.      toggle_autoindent . . . . . . . . . . . . . . . . . . . . . . . . . 58
  5663.      toggle_cmode  . . . . . . . . . . . . . . . . . . . . . . . . . 57, 58
  5664.      toggle_display  . . . . . . . . . . . . . . . . . . . . . . . . . . 71
  5665.      toggle_ins  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
  5666.      toggle_wrap . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
  5667.      top_of_block  . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
  5668.      top_of_file . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
  5669.      top_of_screen . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
  5670.      twokey_def  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
  5671.      ucase_block . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
  5672.      undefine_key  . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
  5673.      unkill  . . . . . . . . . . . . . . . . . . . . . . 34, 43, 56, 68, 78
  5674.      unmark  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63, 67
  5675.      up_page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
  5676.      version_info  . . . . . . . . . . . . . . . . . . . . . . . . .  4, 72
  5677.      vertical_mark . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
  5678.      virtual memory  . . . . . . . . . . . . . . . . . . . . . 1, 6, 13, 14
  5679.      window_bottom . . . . . . . . . . . . . . . . . . . . . . . . . 25, 75
  5680.      window_close  . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
  5681.      window_edit . . . . . . . . . . . . . . . . . . . . . . . . . . 52, 75
  5682.      window_load . . . . . . . . . . . . . . . . . . . . . . . . . . 52, 75
  5683.      window_next . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
  5684.      window_one  . . . . . . . . . . . . . . . . . . . . . . . . 25, 52, 75
  5685.      window_previous . . . . . . . . . . . . . . . . . . . . . . . . 25, 75
  5686.      window_resize . . . . . . . . . . . . . . . . . . . . . . . 25, 52, 76
  5687.      window_split  . . . . . . . . . . . . . . . . . . . . . . . 25, 52, 75
  5688.      window_top  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
  5689.      window_vertical . . . . . . . . . . . . . . . . . . . . . . . . 52, 75
  5690.      window_zoom . . . . . . . . . . . . . . . . . . . . . . . . . . 52, 75
  5691.      word_count  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
  5692.      write_profile . . . . . . . . . . . . . . . . . . . . . . . . . 46, 72
  5693.      zap_file  . . . . . . . . . . . . . . . . . . . . . . . . . . . 36, 61
  5694.  
  5695.  
  5696.  
  5697.  
  5698.  
  5699.  
  5700.  
  5701.  
  5702.  
  5703.  
  5704.  
  5705.  
  5706.  
  5707.  
  5708.  
  5709.  
  5710.  
  5711.  
  5712.                           Bingo 2.10e Reference Manual
  5713.                                        95
  5714.  
  5715.